Deployment Guide

# Install TOS Platform Tools
curl -sSf https://tos.network/install.sh | sh
 
# Verify installation
cargo-tako --version
# cargo-tako 0.3.1
 
# Tools are installed to:
# ~/.cache/tos/v1.54/

~/.cache/tos/v1.54/
├── llvm/     # Clang 20.1.7-rust-dev (TBPFv3 backend)
├── rust/     # Rustc 1.89.0-dev with TBPFv3 target
└── version.md

# Option 1: Use cargo-tako
cargo-tako new my_contract
cd my_contract
 
# Option 2: Manual setup
mkdir my_contract && cd my_contract
cargo init --lib

[package]
name = "my_contract"
version = "0.1.0"
edition = "2021"
 
[lib]
crate-type = ["cdylib"]
 
[dependencies]
tako-sdk = { git = "https://github.com/tos-network/tako", branch = "main" }
 
[profile.release]
opt-level = "z"      # Optimize for size
lto = true           # Link-time optimization
panic = "abort"      # Smaller binary
codegen-units = 1    # Better optimization

[build]
target = "tbpfv3-tos-tos"
 
[target.tbpfv3-tos-tos]
rustflags = [
    "-C", "link-arg=-z", "-C", "link-arg=notext",
]

[toolchain]
channel = "1.89.0-dev"

cargo build --release

#!/bin/bash
set -e
 
echo "Building contract..."
cargo build --release
 
# Copy to project root
cp target/tbpfv3-tos-tos/release/*.so ./
 
echo "Build complete: $(ls *.so)"

chmod +x build.sh
./build.sh

# Check file size (should be small)
ls -lh my_contract.so
 
# Typical size: 5-50 KB for simple contracts

# Start local devnet
tos daemon --network devnet
 
# In another terminal, deploy and test
tos_wallet deploy_contract ./my_contract.so

use tos_test_sdk::*;
 
#[test]
fn test_contract_deploy() {
    let env = TestEnvironment::new();
    let contract = env.deploy("my_contract.so");
    assert!(contract.address().len() > 0);
}
 
#[test]
fn test_contract_call() {
    let env = TestEnvironment::new();
    let contract = env.deploy("my_contract.so");
 
    let result = contract.call(&[0x01]); // Call with opcode 0x01
    assert_eq!(result.status, 0); // SUCCESS
}

# Configure wallet for testnet
tos_wallet config --network testnet
 
# Check balance (need TOS for gas)
tos_wallet balance
 
# Deploy contract
tos_wallet deploy_contract ./my_contract.so
 
# Output:
# Transaction: 0xabc123...
# Contract address: tst1xyz789...

# Configure for mainnet
tos_wallet config --network mainnet
 
# Deploy (requires TOS for gas)
tos_wallet deploy_contract ./my_contract.so
 
# Output:
# Transaction: 0xdef456...
# Contract address: tos1abc123...

# Deploy with specific gas limit
tos_wallet deploy_contract ./my_contract.so --gas-limit 500000
 
# Deploy with initialization data
tos_wallet deploy_contract ./my_contract.so --init-data "00070048656c6c6f"

# Call with hex input
tos_wallet call_contract <address> <hex_input>
 
# Example: Call opcode 0x01 with parameter
tos_wallet call_contract tos1abc123... 01deadbeef
 
# Send TOS with call
tos_wallet call_contract tos1abc123... 01 --value 1000000

# Query (read-only, no gas)
tos_wallet query_contract <address> <hex_input>
 
# Example: Query balance
tos_wallet query_contract tos1abc123... 10<account_address>

# Upload source for verification
tos_wallet verify_contract <address> \
  --source ./src/lib.rs \
  --cargo-toml ./Cargo.toml

// Proxy contract
const KEY_IMPLEMENTATION: &[u8] = b"impl";
 
fn get_implementation() -> [u8; 32] {
    let mut addr = [0u8; 32];
    storage_read(KEY_IMPLEMENTATION, &mut addr);
    addr
}
 
#[no_mangle]
pub extern "C" fn entrypoint() -> u64 {
    let mut input = [0u8; 10240];
    let len = get_input_data(&mut input);
 
    // Delegate to implementation
    let impl_addr = get_implementation();
    let mut return_buf = [0u8; 10240];
 
    match cpi_call(&impl_addr, &input[..len as usize], &mut return_buf) {
        Ok(ret_len) => {
            let _ = set_return_data(&return_buf[..ret_len as usize]);
            SUCCESS
        }
        Err(e) => e,
    }
}

# Error: toolchain not found
# Solution: Install platform tools
curl -sSf https://tos.network/install.sh | sh
 
# Error: target not found
# Solution: Check .cargo/config.toml

# Error: insufficient balance
# Solution: Get testnet TOS from faucet
tos_wallet faucet
 
# Error: contract too large
# Solution: Enable LTO and size optimization

# Error: compute exceeded
# Solution: Increase gas limit or optimize code
 
# Error: storage write failed
# Solution: Check contract has permission