- Shell 61.5%
- TypeScript 31.8%
- Dockerfile 6.7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| chain | ||
| contracts | ||
| deployer-bot | ||
| node@3c270858e8 | ||
| wallet-generator | ||
| .gitignore | ||
| .gitmodules | ||
| CONFIGURATION.md | ||
| DEVELOPMENT.md | ||
| LICENSE | ||
| README.md | ||
ASI Chain
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
- Overview
- Key Features
- Related Repositories
- Quick Start
- Architecture
- Project Structure
- Documentation
- 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:
- ASI Wallet: https://wallet.dev.asichain.io
- Block Explorer: https://explorer.dev.asichain.io
- Faucet: https://faucet.dev.asichain.io
- Documentation: https://docs.asichain.io
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:
- Building ASI Chain node Docker image from
node/submodule - Building Rust CLI from external repository
- Configuring and starting network services
- 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:
- Web Wallet (https://wallet.dev.asichain.io) - Account management and contract deployment
- Block Explorer (https://explorer.dev.asichain.io) - Real-time network monitoring
- Indexer - Blockchain data indexing for efficient queries
- Faucet (https://faucet.dev.asichain.io) - Test token distribution
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:
- Main Portal: https://docs.asichain.io
- Quick Start: https://docs.asichain.io/quick-start/join-validator/
- DevNet Structure: https://docs.asichain.io/shard-nodes/devnet-structure/
Network Endpoints:
- Bootstrap Node:
rnode://2843a0bed9dcc8616d711f0be25d775a87bce831@34.196.119.4?protocol=40400&discovery=40404 - Bootstrap HTTP: http://34.196.119.4:40403
- Observer HTTP: http://54.235.138.68:40403
Note
Bootstrap for External Nodes is a Validator 1 of the Genesis Shard
Repositories:
- Core: https://github.com/asi-alliance/asi-chain
- Rust Client: https://github.com/singnet/rust-client
- Block Explorer: https://github.com/asi-alliance/asi-chain-explorer
- Web Wallet: https://github.com/asi-alliance/asi-chain-wallet
- Faucet: https://github.com/asi-alliance/asi-chain-faucet
- Documentation Portal: https://github.com/asi-alliance/asi-chain-docs-portal
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