DatabØx Documentation

# Install via Cargo
cargo install rope-cli

# Or build from source
git clone https://github.com/AltterOS/databox.git
cd databox/crates/rope-cli
cargo build --release

# Run the CLI
./target/release/rope-cli --rpc https://erpc.datachain.network

[network]
rpc_url = "https://erpc.datachain.network"
ws_url = "wss://ws.datachain.network"
chain_id = 314159

[wallet]
keystore_path = "~/.rope/keystore"
default_account = "0x..."

[crypto]
enable_pq_crypto = true    # CRYSTALS-Dilithium3 + Kyber768
oes_generation = 1         # OES evolution epoch

rope-cli wallet create --name "my-wallet"

# Output:
# ✓ Wallet Created Successfully
#   Address: 0x1a2b3c4d5e6f7890...
#   Public Key: dilithium3_pk_...

RopeString {
    id: StringId,               // Unique identifier (256-bit hash)
    creator: ValidatorId,       // Creating validator's public key
    timestamp: Timestamp,       // Logical timestamp (not wall clock)
    payload: Payload,           // Transaction data or testimony
    self_parent: Option<StringId>,   // Previous string from same creator
    other_parent: Option<StringId>,  // Latest string from other validator
    signature: Signature,       // Post-quantum signature (Dilithium3)
    nucleotide: Nucleotide,     // A, T, C, G – encodes string type
}

Testimony {
    string_id: StringId,        // String being validated
    validator: ValidatorId,     // AI validator identity
    verdict: Verdict,           // VALID, INVALID, or NEEDS_REVIEW
    confidence: f64,            // Confidence score (0.0 - 1.0)
    evidence: Vec<Evidence>,    // Supporting evidence
    timestamp: Timestamp,       // When testimony was created
    signature: Signature,       // Validator's signature
}

// Available Protocol Invocations
Datachain Rope // Native protocol (required)
Hyperledger    // Enterprise blockchain
XDC Network    // XinFin hybrid chain
Solana         // High-performance chain
Polkadot       // Cross-chain protocol
Bitcoin        // Store of value layer
Ethereum       // Smart contracts
Tangle         // IOTA DAG (coming soon)
Hashgraph      // Hedera consensus (coming soon)

rope-cli wallet create --name "personal-vault" --type sovereign

# Options:
#   --name       Wallet name
#   --type       sovereign | managed | custodial
#   --backup     Generate backup phrase
#   --hardware   Use hardware key (YubiKey, Ledger)

# Output:
# ✓ Data Wallet Created
#   Address: 0x7a8b9c...
#   Type: Sovereign
#   Encryption: CRYSTALS-Kyber768
#   Signature: CRYSTALS-Dilithium3

{
  "jsonrpc": "2.0",
  "method": "rope_networkStatus",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "status": "healthy",
    "finality_time_ms": 4200,
    "active_validators": 127,
    "ai_agents": 5,
    "latest_round": 847291,
    "total_strings": 1847293,
    "chain_id": 314159
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "method": "rope_submitString",
  "params": [{
    "content": "0x...",
    "parents": ["0x...", "0x..."],
    "mutability_class": "immutable",
    "requires_testimony": true,
    "signature": "0x..."
  }],
  "id": 1
}

const ws = new WebSocket('wss://ws.datachain.network');

ws.onopen = () => {
  ws.send(JSON.stringify({
    method: 'subscribe',
    params: ['newStrings'],
    id: 1
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('New string:', data);
};

import { RopeClient } from '@datachain/rope-sdk';

const client = new RopeClient({
  rpcUrl: 'https://erpc.datachain.network',
  chainId: 314159
});

// Get network status
const status = await client.getStatus();
console.log('Network health:', status.health);

// Submit a string
const result = await client.submitString({
  payload: { type: 'transfer', to: '0x...', amount: 100 },
  requiresTestimony: true
});

#[rope_contract]
pub mod token {
    use rope_sdk::prelude::*;

    #[state]
    pub struct Token {
        balances: Map<Address, u128>,
        total_supply: u128,
    }

    #[init]
    pub fn new(initial_supply: u128) -> Self {
        let mut balances = Map::new();
        balances.insert(msg::sender(), initial_supply);
        Token { balances, total_supply: initial_supply }
    }

    #[action]
    pub fn transfer(&mut self, to: Address, amount: u128) -> Result<()> {
        let sender = msg::sender();
        let sender_balance = self.balances.get(&sender).unwrap_or(0);
        require!(sender_balance >= amount, "Insufficient balance");
        
        self.balances.insert(sender, sender_balance - amount);
        let to_balance = self.balances.get(&to).unwrap_or(0);
        self.balances.insert(to, to_balance + amount);
        
        Ok(())
    }
}

┌─────────────────────────────────────────────────────────────────────────┐
│                    datachain.network (ROPE NETWORK)                      │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│   CORE PROTOCOL (rope-node)                                             │
│   ─────────────────────────                                             │
│   • Post-Quantum Crypto (Dilithium3/Kyber768)       ✅ 100%             │
│   • Virtual Voting (Appendix B.1)                    ✅ 100%             │
│   • Reed-Solomon Erasure Coding                      ✅ 100%             │
│   • libp2p Transport (QUIC+TCP)                      ✅ 100%             │
│   • AI Testimony Validation                          ✅ 100%             │
│   • OES Cryptography                                 ✅ 100%             │
│   • Federation/Community Management                  ✅ 100%             │
│                                                                          │
│   NETWORK SERVICES                                                       │
│   ────────────────                                                       │
│   erpc.datachain.network  → JSON-RPC                                    │
│   ws.datachain.network    → WebSocket                                   │
│   faucet.datachain.network                                              │
│   bridge.datachain.network                                              │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘
                                │
                                │ Indexes & Fetches Data
                                ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                      dcscan.io (BLOCK EXPLORER)                          │
│   • View Strings & Transactions                                         │
│   • Browse AI Agents & Testimonies                                      │
│   • Network Statistics & Charts                                         │
│   • Community Voting                                                    │
└─────────────────────────────────────────────────────────────────────────┘