本页目录

API 参考

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

方法

方法	说明
`connect()`	连接钱包并获取账户
`disconnect()`	断开钱包连接
`isConnected()`	检查连接状态
`account()`	获取当前账户信息
`network()`	获取当前网络名称
`getNetwork()`	获取完整网络信息
`getNetworkURL()`	获取网络 RPC URL
`signMessage(request)`	签署消息
`signAndSubmitTransaction(payload)`	签名并提交交易
`signTransaction(payload)`	仅签名，不提交交易
`signTransactionV2(params)`	签署经 BCS 序列化的交易
`signAndSubmitTransactionV2(params)`	签名并提交交易（Standard V1.1.0）
`signIn(payload)`	AIP 登录流程
`onAccountChange(callback)`	监听账户变化
`onNetworkChange(callback)`	监听网络变化
`onDisconnect(callback)`	监听连接断开

类型

账户信息


interface AptosAccountInfo {
  address: string    // Hex address with 0x prefix
  publicKey: string  // Ed25519 public key
}

网络信息


interface AptosNetwork {
  name: string       // Network name
  chainId: number    // Chain ID
  url: string        // RPC URL
}

签署消息请求


interface SignMessageRequest {
  message: string    // Message to sign
  nonce: number      // Required by the direct provider API
  address?: boolean  // Include address in message
  application?: boolean // Include app info
  chainId?: boolean  // Include chain ID
}

签署消息响应


interface SignMessageResponse {
  signature: string     // Hex signature
  fullMessage: string   // Complete signed message
  prefix: string        // APTOS prefix
  address?: string      // Signer address
  application?: string  // Application info
  chainId?: number      // Chain ID
  nonce: number         // Nonce used
}

交易 Payload


interface TransactionPayload {
  type: 'entry_function_payload' | 'script_payload' | 'module_bundle_payload'
  function: string       // Module::function format
  type_arguments: string[]
  arguments: any[]
}

签署交易 V2 参数


interface SignTransactionV2Params {
  transaction: string        // BCS serialized transaction
  transactionType: 'simple' | 'multi_agent'
  asFeePayer?: boolean       // Sign as fee payer
}

支持的网络

网络	描述
Mainnet	生产网络
Testnet	测试环境
Devnet	开发环境

事件

事件	回调参数	描述
`accountChanged`	`address: string \| null`	账户已变更
`accountChangedV2`	`account: AptosAccountInfo \| null`	账户已变更（完整信息）
`networkChange`	`network: string \| null`	网络已变更
`disconnect`	-	钱包已断开连接

错误码

错误码	描述
4001	用户拒绝请求
4100	未授权
4200	不支持的方法
4201	不支持的网络
-32603	内部错误