# NanoStack

Permissionless cross-chain execution API. Native asset settlement. No wrapping. No SDK. No API key.

Base URL: https://api.nano-labs.io

## How to use

### Get a quote (required before executing)
POST /v1/quote
Content-Type: application/json

{"chain_id": 8453, "amount": "1000000000000000000", "destination": "0xYourAddress"}

Response: {"ok": true, "quote_id": "...", "fee_bps": 10, "fee_amount": "...", "net_amount": "...", "expires_at": ...}

### Execute a transfer
POST /v1/execute
Content-Type: application/json

{"chain_id": 8453, "amount": "1000000000000000000", "destination": "0xYourAddress"}

Response: {"ok": true, "tx_hash": "0x...", "proof": "...", "fee_bps": 10}

### Cross-chain transfer (e.g. Cosmos ATOM → Ethereum)
POST /v1/cross-chain
Content-Type: application/json

{"src_chain_id": 118, "dst_chain_id": 1, "amount": "1000000", "denom": "uatom", "destination": "0xYourEthAddress"}

### Health check
GET /v1/health → {"ok": true, "status": "healthy"}

### Full manifest (chains, schemas, fee model)
GET /.well-known/nanostack.json

## Supported chains (46 total)

EVM (40): Ethereum(1), Base(8453), Arbitrum(42161), Optimism(10), Polygon(137), BNB(56), Avalanche(43114), Scroll(534352), zkSync(324), Linea(59144), Blast(81457), Mantle(5000), Mode(34443), Taiko(167000), Manta(169), Fraxtal(252), Ink(57073), Zora(7777777), Unichain(130), World(480), Xai(660279), XLayer(196), Gnosis(100), Fantom(250), Sei(1329), Celo(42220), Cronos(25), Moonbeam(1284), Astar(592), Aurora(1313161554), Kava(2222), Metis(1088), Boba(288), Harmony(1666600000), Degen(666666666), Filecoin(314), Hedera(295), Ronin(2020), ArbNova(42170), PolyZkEVM(1101)
Non-EVM: Bitcoin(0), Solana(501), Cosmos(118), XRP(144), Aptos(637), Sui(784)

## Fee model
- 8-15 bps (basis points), size-tiered
- Base: 10 bps. Range: 8-15 bps.
- Locked at quote time, valid 30 seconds
- Deducted from execution amount
- Permissionless: no API key required

## Field reference

Common fields (all chains):
- chain_id (u64, required): target chain ID from list above
- amount (string, required): smallest unit — wei for EVM, satoshis for BTC, lamports for SOL, uatom for Cosmos, drops for XRP, octas for APT, MIST for SUI
- destination (string, required): chain-native address

EVM only: token_address (ERC20 hex), gas_priority (low/medium/high)
Solana only: token_mint (base58 SPL mint), priority_fee_lamports (u64)
Cosmos only: denom (e.g. uatom), memo (REQUIRED for exchange deposits)
XRP only: destination_tag (u32, REQUIRED for exchange deposits)
BTC only: fee_rate (sat/vbyte), change_address
Move (APT/SUI): coin_type (full Move type path)

## Conservation
Every execution enforces: gross == net + fee
Proven via BLAKE3 on SubZero ledger 2477.