Ship dApps, tools, and public goods on Sanaol

Install CLI

Use the CLI to scaffold projects, manage keys, and talk to the network.

# install
npm i -g sana-cli

# verify
sana --version

# connect to public testnet
sana config set network testnet

# get test tokens (soon)
sana faucet <your_address>

Hello, Contract

Scaffold a Rust contract, run tests, and deploy.

# scaffold
sana new hello-contract
cd hello-contract

# build & test
sana build
sana test

# deploy
sana deploy --network testnet --key ~/.sana/keys/dev.json

JavaScript SDK

High-level helpers for JSON-RPC, key mgmt, and tx building.

import { Client } from "@sana/sdk";

const c = new Client({ rpc: "https://test-rpc.sanaol.net" });
const block = await c.getBlock("latest");
console.log(block.number);

Rust Crates

Contracts, serialization, and crypto utilities.

[dependencies]
sana-contract = "0.1"
sana-crypto = "0.1"

Dev Tools

• Explorer — inspect blocks/txns/logs
• Localnet — spin up a local single-node
• Key/Wallet — create, import, and sign
• Faucet — test tokens (soon)

Mainnet (planned)

• Chain: sana-mainnet
• RPC: https://rpc.sanaol.net
• WS: wss://rpc.sanaol.net/ws

Testnet (public)

• Chain: sana-testnet
• RPC: https://test-rpc.sanaol.net
• WS: wss://test-rpc.sanaol.net/ws

Faucet & explorer

• Faucet: (soon)
• Explorer: /explorer
• Docs: /docs

Devnet / Localnet

• Chain: sana-devnet
• RPC: http://127.0.0.1:8899
• WS: ws://127.0.0.1:8899/ws

For local testing and CI pipelines.

Checklist

• Threat model + abuse cases
• Rate limit RPC & endpoints
• Keys: hardware or secure enclave
• Use audited libs and pinned deps
• Formal reviews for critical paths

Testing & audits

Write property tests, fuzz critical functions, and consider external audits for mainnet deployments.

Read: /docs#security