本页目录

API 参考

OneKey TON provider 的方法和类型参考。

方法

方法	描述
`connect(version?, request?)`	连接钱包
`restoreConnection()`	恢复之前的会话
`disconnect()`	断开钱包连接
`send(message)`	发送 RPC 请求
`listen(callback)`	监听钱包事件

Send 方法

方法	描述
`sendTransaction`	发送 TON 或与合约交互
`signData`	签署任意数据 cell
`disconnect`	通过 RPC 断开连接

类型

账户信息


interface AccountInfo {
  address: string      // Raw address (0:<hex>)
  network: string      // Network ID (-239 mainnet, -3 testnet)
  publicKey: string    // Hex public key (no 0x)
  walletStateInit: string // Base64 encoded state init
}

交易请求


interface TransactionRequest {
  valid_until?: number  // UNIX timestamp for validity
  network?: string      // Network ID
  from?: string         // Sender address
  messages: Message[]   // Respect the wallet-advertised maximum
}

消息


interface Message {
  address: string      // Recipient (raw format)
  amount: string       // Amount in nanotons
  payload?: string     // Base64 BOC for contract calls
  stateInit?: string   // Base64 StateInit for deployment
}

签署数据请求


interface SignDataRequest {
  schema_crc: number   // Schema identifier
  cell: string         // Base64 encoded cell
  publicKey?: string   // Optional specific key
}

签署数据结果


interface SignDataResult {
  signature: string    // Base64 signature
  timestamp: number    // UNIX timestamp (UTC)
}

设备信息


interface DeviceInfo {
  platform: string     // 'iphone' | 'android' | 'windows' | 'mac' | 'linux'
  appName: string      // 'onekey'
  appVersion: string   // Wallet version
  maxProtocolVersion: number // 2
  features: Array<string | { name: string; maxMessages?: number; [key: string]: unknown }> // Advertised capabilities
}

网络

网络	网络 ID
主网	-239
测试网	-3

事件

事件	描述
`accountChanged`	账户已变更
`disconnect`	钱包已断开连接

错误码

错误码	描述
0	未知错误
1	请求错误
100	未知应用
300	用户拒绝请求
400	不支持的方法