Skip to content

asi-alliance/asi-chain

BranchesTags

Repository files navigation

ASI Chain

Status Version License Docs

Blockchain node infrastructure and deployment tools for the ASI Chain network

Part of the Artificial Superintelligence Alliance ecosystem

Uniting Fetch.ai, SingularityNET, and CUDOS

Table of Contents

  1. Overview
  2. Key Features
  3. Related Repositories
  4. Quick Start
  5. Architecture
  6. Project Structure
  7. Documentation
  8. Contributing
  9. License

Overview

ASI Chain is a blockchain platform providing infrastructure for the ASI Alliance ecosystem. This repository contains the node configuration, deployment automation, and utilities needed to run and interact with the ASI Chain network.

The platform uses the CBC Casper consensus mechanism with Proof of Stake, enabling validators to participate in block production and network security. Smart contracts are written in Rholang, a concurrent programming language designed for blockchain applications.

Key Features

  • Validator Configuration - Complete setup for running validator nodes with bonding support
  • Wallet Generation - TypeScript utility for generating secp256k1 key pairs compatible with ASI Chain
  • Docker Support - Containerized deployment for all node types (bootstrap, validator, observer)
  • Deployment Automation - Bot for continuous contract deployment and block proposal
  • Node Configurations - Pre-configured genesis nodes (bootstrap, validators, observer) for DevNet

Related Repositories

ASI Chain ecosystem consists of multiple components working together:

Repository Description Status
asi-chain-wallet Web-based wallet with Rholang IDE ✅ Active
asi-chain-explorer Blockchain explorer and indexer ✅ Active
asi-chain-faucet Testnet token distribution service ✅ Active
asi-chain-docs-portal Official documentation portal ✅ Active

Production Services:

Quick Start

Prerequisites

  • Docker 20.10+ and Docker Compose 2.0+
  • Java 17+ (OpenJDK)
  • sbt 1.9+ (Scala Build Tool)
  • Rust 1.70+ and Cargo
  • Node.js 20+ (for wallet-generator)
  • Git 2.30+
  • Make and Perl

System requirements: 16GB RAM minimum, 4+ CPU cores, 50GB free storage

Manual Network Setup

# Clone with submodules
git clone --recursive https://github.com/asi-alliance/asi-chain.git
cd asi-chain

# Initialize submodule (ASI Chain node)
git submodule update --init --recursive

Note: Automated deployment scripts are planned for future releases. Currently, use manual deployment steps outlined in DEVELOPMENT.md.

Manual deployment requires:

  1. Building ASI Chain node Docker image from node/ submodule
  2. Building Rust CLI from external repository
  3. Configuring and starting network services
  4. Verifying network operational status

See DEVELOPMENT.md for complete manual deployment instructions.

Architecture

Network Topology

The DevNet consists of multiple node types with decentralized peer-to-peer communication:

                    ┌─────────────┐
                    │  Bootstrap  │ ← Network entry point
                    └─────┬───────┘    for peer discovery
                          │
            ┌─────────────┼─────────────┐
            │             │             │
            ▼             ▼             ▼
      ┌──────────┐  ┌──────────┐  ┌──────────┐
      │Validator │  │Validator │  │Validator │
      │    1     │  │    2     │  │    3     │
      └──────────┘  └──────────┘  └──────────┘
            │             │             │
            └─────────────┼─────────────┘
                          │
              Direct P2P mesh network            ┌──────────────────┐
           (consensus & block production) =====> │     Observer     │
                                                 │   (Read-only)    │
                                                 │                  │
                                                 │ Syncs & indexes  │
                                                 │ blocks from all  │
                                                 │ validator nodes  │
                                                 └──────────────────┘

Bootstrap Node:

  • Genesis node that initializes the network
  • Provides initial peer discovery for new nodes
  • Nodes learn about each other through bootstrap, then communicate directly
  • Not a central coordinator - peers form independent mesh network

Validator Nodes (3 Active):

  • Discover peers via bootstrap, then communicate directly with each other
  • Form decentralized P2P mesh for consensus and block propagation
  • Participate in consensus through CBC Casper
  • Produce and finalize blocks independently
  • Accept transaction submissions from users and developers

Observer Node:

  • Connects to network via bootstrap for peer discovery
  • Receives blocks from all validators across the network (read-only synchronization)
  • Read-only access to blockchain state
  • Handles query requests from client applications
  • Does not participate in consensus or block production
  • Optimized for high-throughput read operations

Participant Roles

External Participants:

  • Users - Interact with the blockchain through client applications (transfers, balance checks)
  • Developers - Deploy and test smart contracts via validator nodes
  • Node Operators - Run validator or observer nodes to support network infrastructure

Client Applications:

Technology Stack

Core Infrastructure:

  • ASI Chain Node (Scala) - Blockchain node implementation based on RChain
  • Rust Client (CLI) - Command-line interface for node interaction
  • Docker - Containerization platform

Utilities:

  • TypeScript - Wallet key generation
  • Bash - Deployment automation scripts
  • Rholang - Smart contract programming language

Dependencies from package.json:

  • @noble/curves 1.4.0 - Elliptic curve cryptography
  • @scure/base 1.1.6 - Base encoding utilities
  • blakejs 1.2.1 - BLAKE2 hashing
  • js-sha3 0.9.3 - SHA-3 hashing
  • js-sha256 0.11.0 - SHA-256 hashing
  • TypeScript 5.4.5 - Type-safe JavaScript

Project Structure

asi-chain/
├── node/                      # ASI Chain node (Git submodule)
│   └── docker/               # Node Docker configurations
│
├── chain/                     # Node configurations
│   ├── genesis/              # Genesis node configurations
│   │   ├── devnet-bootstrap/ # Bootstrap node setup
│   │   ├── devnet-validator1-3/ # Validator configurations
│   │   └── devnet-observer/  # Observer node setup
│   └── validator/            # External validator setup
│       ├── conf/             # Configuration files
│       ├── scripts/          # Setup and connection scripts
│       ├── configurator.Dockerfile
│       ├── connector.Dockerfile
│       └── validator.yml     # Docker Compose file
│
├── wallet-generator/          # Wallet key generation utility
│   ├── walletGeneratorScript.ts
│   ├── utils.ts
│   ├── package.json
│   └── README.md
│
├── deployer-bot/              # Automated deployment bot
│   ├── bot.sh                # Deployment automation script
│   ├── Dockerfile
│   ├── deployer.yml
│   └── .env.example
│
├── scripts/                   # Utility scripts (automation planned)
│   ├── deploy.sh             # Network deployment (in development)
│   ├── block-generator.sh
│   └── docker-flush.sh
│
├── contracts/                 # Rholang smart contracts
│   └── hello.rho
│
└── README.md                  # This file

Note: The node/ directory is a Git submodule pointing to the ASI Chain node implementation. Initialize it with git submodule update --init --recursive.

Documentation

Core Documentation

CONFIGURATION.md - Configuration guide

  • Environment variables for all components
  • Network configuration parameters
  • Docker deployment settings

DEVELOPMENT.md - Development guide

  • Local development setup
  • Building from source
  • Manual deployment steps
  • Troubleshooting common issues

Component Documentation

chain/README.md - Node configurations

  • Genesis nodes overview
  • DevNet structure
  • External validator setup

chain/validator/README.md - External validator setup

  • Complete validator deployment guide
  • Docker image building
  • Bonding process
  • Node synchronization verification

wallet-generator/README.md - Wallet generation

  • Key generation process
  • secp256k1 algorithm usage
  • Secure key storage recommendations

deployer-bot/README.md - Deployment automation

  • Bot configuration
  • Automated contract deployment
  • Block proposal automation

External Resources

Official Documentation Portal:

Network Endpoints:

Note

Bootstrap for External Nodes is a Validator 1 of the Genesis Shard

Repositories:

Contributing

Known issues and bugs are tracked in the Issues section.
If you encounter a problem that is not listed, please feel free to open a new issue and provide as much detail as possible.

For acknowledgments, see ACKNOWLEDGMENTS.md.

License

Copyright 2025 Artificial Superintelligence Alliance

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

ASI Alliance founding members: Fetch.ai, SingularityNET, and CUDOS

About

https://docs.asichain.io

Resources

Readme

License

Apache-2.0 license
Activity
Custom properties

Stars

11 stars

Watchers

1 watching

Forks

3 forks
Report repository

Releases 1

ASI Chain v0.1.0 Latest
Nov 14, 2025

Packages

 
 
 

Contributors

Languages