智能合约

交易 (Deploy/Call)
        │
        ▼
┌─────────────────┐
│   World State   │  ← 合约代码、存储、余额
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│    VM Engine     │  ← wasmer singlepass 编译器
│                  │
│  ┌────────────┐  │
│  │  Wasm Inst │  │  ← 每次调用创建新实例
│  └─────┬──────┘  │
│        │         │
│  ┌─────▼──────┐  │
│  │ Host Funcs │  │  ← 17 个 "env" 命名空间导入
│  └────────────┘  │
└────────┬─────────┘
         │
         ▼
   状态变更
   (存储、转账、日志)

address = blake3("claw_contract_v1:" + deployer_pubkey + nonce_le_bytes)

# 安装 Wasm 编译目标
rustup target add wasm32-unknown-unknown

#![no_std]

// 宿主函数声明
extern "C" {
    fn storage_read(key_ptr: u32, key_len: u32, val_ptr: u32) -> i32;
    fn storage_write(key_ptr: u32, key_len: u32, val_ptr: u32, val_len: u32);
    fn caller(out_ptr: u32);
    fn return_data(ptr: u32, len: u32);
    fn log_msg(ptr: u32, len: u32);
}

// 必须导出：内存分配器
static mut HEAP_PTR: u32 = 1024 * 64; // 从 64KB 开始

#[no_mangle]
pub extern "C" fn alloc(size: i32) -> i32 {
    unsafe {
        let ptr = HEAP_PTR;
        HEAP_PTR += size as u32;
        ptr as i32
    }
}

// 合约方法
#[no_mangle]
pub extern "C" fn init() {
    let msg = b"contract initialized";
    unsafe { log_msg(msg.as_ptr() as u32, msg.len() as u32) };
}

#[no_mangle]
pub extern "C" fn get_owner(_args_ptr: i32, _args_len: i32) {
    let key = b"owner";
    let mut buf = [0u8; 32];
    let len = unsafe { storage_read(key.as_ptr() as u32, key.len() as u32, buf.as_ptr() as u32) };
    if len > 0 {
        unsafe { return_data(buf.as_ptr() as u32, len as u32) };
    }
}

#[no_mangle]
pub extern "C" fn set_owner() {
    let key = b"owner";
    let mut owner = [0u8; 32];
    unsafe { caller(owner.as_ptr() as u32) };
    unsafe {
        storage_write(
            key.as_ptr() as u32,
            key.len() as u32,
            owner.as_ptr() as u32,
            32,
        )
    };
}

cargo build --target wasm32-unknown-unknown --release

# 通过 sendTransaction 部署，TxType = 6
curl -X POST http://localhost:9710 -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "claw_sendTransaction",
    "params": ["<hex-encoded-borsh-tx-with-ContractDeploy-payload>"]
  }'

# 获取合约信息
curl -X POST http://localhost:9710 -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "claw_getContractInfo",
    "params": ["<contract-address-hex>"]
  }'

#![no_std]

extern "C" {
    fn caller(out_ptr: u32);
    fn agent_is_registered(addr_ptr: u32) -> i32;
    fn agent_get_score(addr_ptr: u32) -> i64;
    fn value_lo() -> i64;
    fn value_hi() -> i64;
    fn storage_write(key_ptr: u32, key_len: u32, val_ptr: u32, val_len: u32);
    fn storage_read(key_ptr: u32, key_len: u32, val_ptr: u32) -> i32;
    fn token_transfer(to_ptr: u32, amount_lo: i64, amount_hi: i64) -> i32;
    fn return_data(ptr: u32, len: u32);
    fn abort(ptr: u32, len: u32);
}

static mut HEAP_PTR: u32 = 1024 * 64;

#[no_mangle]
pub extern "C" fn alloc(size: i32) -> i32 {
    unsafe {
        let ptr = HEAP_PTR;
        HEAP_PTR += size as u32;
        ptr as i32
    }
}

const MIN_SCORE: i64 = 50;

#[no_mangle]
pub extern "C" fn deposit() {
    let mut sender = [0u8; 32];
    unsafe { caller(sender.as_ptr() as u32) };

    // 门控：必须是已注册 Agent
    let registered = unsafe { agent_is_registered(sender.as_ptr() as u32) };
    if registered != 1 {
        let msg = b"not a registered agent";
        unsafe { abort(msg.as_ptr() as u32, msg.len() as u32) };
    }

    // 门控：信誉分必须达标
    let score = unsafe { agent_get_score(sender.as_ptr() as u32) };
    if score < MIN_SCORE {
        let msg = b"reputation too low";
        unsafe { abort(msg.as_ptr() as u32, msg.len() as u32) };
    }

    // 记录存款
    let amount = unsafe { value_lo() } as u64;
    let amount_bytes = amount.to_le_bytes();
    unsafe {
        storage_write(
            sender.as_ptr() as u32, 32,
            amount_bytes.as_ptr() as u32, 8,
        );
    }
}

curl -X POST http://localhost:9710 -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "claw_callContractView",
    "params": [
      "CONTRACT_ADDRESS_HEX",
      "get_owner",
      ""
    ]
  }'