Skip to Content
dAppsSui
En esta página

Sui

Los siguientes ejemplos de firma usan connectSuiAccount() de Primeros pasos. Devuelve una cuenta de Wallet Standard y su cadena activa. Los ejemplos usan @mysten/[email protected]. Incluso los métodos antiguos *TransactionBlock ahora declaran entradas Transaction en @mysten/[email protected].

Integra la cadena de bloques Sui mediante el proveedor de OneKey. Accede a través de window.$onekey.sui.

OneKey implementa Sui Wallet Standard para integraciones compatibles con wallet-standard.

Detección del proveedor

// Detect OneKey Sui provider
const provider = window.$onekey?.sui
 
if (!provider) {
  throw new Error('OneKey Sui provider not detected')
}

Inicio rápido

Comprobar permisos

// Check if already connected
const hasPermission = await provider.hasPermissions()
 
if (hasPermission) {
  const accounts = await provider.getAccounts()
  console.log('Connected accounts:', accounts)
}

Solicitar conexión

// Request permissions to connect
const result = await provider.requestPermissions()
 
if (result) {
  const accounts = await provider.getAccounts()
  console.log('Connected:', accounts[0].address)
}

Desconectar

await provider.disconnect()

Administración de cuentas

Obtener cuentas

const accounts = await provider.getAccounts()
 
accounts.forEach(account => {
  console.log({
    address: account.address,     // Sui address
    publicKey: account.publicKey, // Public key (hex string)
  })
})

Obtener la cadena activa

const chain = await provider.getActiveChain()
 
console.log('Active chain:', chain) // e.g., 'sui:testnet'

Transacciones

Firmar y ejecutar un bloque de transacción

El proveedor inyectado actual no reenvía options en signAndExecuteTransactionBlock. Consulta el digest devuelto con un cliente Sui en la misma cadena para solicitar efectos, eventos o cambios de objetos.

import { Transaction } from '@mysten/sui/transactions'
 
// Create transaction block
const txb = new Transaction()
 
// Add a transfer
txb.transferObjects(
  [txb.object('0xobject_id')],
  txb.pure.address('RECIPIENT_SUI_ADDRESS')
)
 
// Or send SUI
const [coin] = txb.splitCoins(txb.gas, [txb.pure.u64(1000000000)]) // 1 SUI
txb.transferObjects([coin], txb.pure.address('RECIPIENT_SUI_ADDRESS'))
 
const { account, chain } = await connectSuiAccount()
 
// Sign and execute
const result = await provider.signAndExecuteTransactionBlock({
  account,
  chain,
  transactionBlock: txb,
})
 
console.log({
  digest: result.digest,
})

Firmar un bloque de transacción (sin ejecutarlo)

const txb = new Transaction()
// ... build transaction
 
const { account, chain } = await connectSuiAccount()
 
const signedTxb = await provider.signTransactionBlock({
  account,
  chain,
  transactionBlock: txb,
})
 
console.log({
  transactionBlockBytes: signedTxb.transactionBlockBytes,
  signature: signedTxb.signature,
})
 
// Execute later using Sui SDK
// const result = await suiClient.executeTransactionBlock({
//   transactionBlock: signedTxb.transactionBlockBytes,
//   signature: signedTxb.signature,
// })

Firmar y ejecutar una transacción (API nueva)

// Using the newer signAndExecuteTransaction API (Transaction type)
import { Transaction } from '@mysten/sui/transactions'
 
const tx = new Transaction()
// ... build transaction
 
const { account, chain } = await connectSuiAccount()
 
const result = await provider.signAndExecuteTransaction({
  account,
  chain,
  transaction: tx,
})

Firmar una transacción (API nueva)

import { Transaction } from '@mysten/sui/transactions'
 
const tx = new Transaction()
// ... build transaction
 
const { account, chain } = await connectSuiAccount()
 
const signedTxn = await provider.signTransaction({
  account,
  chain,
  transaction: tx,
})

Firma de mensajes

Firmar un mensaje personal

Firma mensajes arbitrarios para autenticación:

const message = new TextEncoder().encode('Hello, Sui!')
const { account, chain } = await connectSuiAccount()
 
const result = await provider.signPersonalMessage({
  account,
  chain,
  message,
})
 
console.log({
  signature: result.signature,   // Base64 encoded signature
  bytes: result.bytes,           // Signed message bytes
})

Firmar un mensaje (heredado)

const message = new TextEncoder().encode('Hello, Sui!')
const { account, chain } = await connectSuiAccount()
 
const result = await provider.signMessage({
  account,
  message,
})
 
console.log({
  signature: result.signature,
  messageBytes: result.messageBytes,
})

Verificar la firma

import { verifyPersonalMessageSignature } from '@mysten/sui/verify'
 
const message = new TextEncoder().encode('Hello, Sui!')
const { account, chain } = await connectSuiAccount()
const { signature } = await provider.signPersonalMessage({ message, account, chain })
 
const signerKey = await verifyPersonalMessageSignature(message, signature)
const isExpectedSigner = signerKey.toSuiAddress() === account.address
console.log('Expected signer:', isExpectedSigner)

Interacción con contratos inteligentes

Llamada Move

const txb = new Transaction()
 
// Call a Move function
txb.moveCall({
  target: '0xpackage::module::function',
  arguments: [
    txb.pure.string('arg1'),
    txb.object('0xobject_id'),
  ],
  typeArguments: ['0x2::sui::SUI'],
})
 
const { account, chain } = await connectSuiAccount()
 
const result = await provider.signAndExecuteTransactionBlock({
  account,
  chain,
  transactionBlock: txb,
})

Publicar un paquete

const txb = new Transaction()
 
const [upgradeCap] = txb.publish({
  modules: compiledModules,
  dependencies: [
    '0x1', // Move stdlib
    '0x2', // Sui framework
  ],
})
 
const { account, chain } = await connectSuiAccount()
txb.transferObjects([upgradeCap], txb.pure.address(account.address))
 
const result = await provider.signAndExecuteTransactionBlock({
  account,
  chain,
  transactionBlock: txb,
})

Referencia de la API

Métodos

MétodoDescripción
hasPermissions()Comprobar si está conectado
requestPermissions()Solicitar conexión
disconnect()Desconectar la cartera
getAccounts()Obtener las cuentas conectadas (solo address, publicKey)
getActiveChain()Obtener la cadena actual
signAndExecuteTransactionBlock(input)Firmar y ejecutar; requiere account/chain
signTransactionBlock(input)Solo firmar; requiere account/chain
signAndExecuteTransaction(input)Firmar y ejecutar (API nueva, Transaction, requiere account/chain)
signTransaction(input)Firmar una transacción (API nueva, Transaction, requiere account/chain)
signMessage(input)Firmar un mensaje (heredado, requiere account)
signPersonalMessage(input)Firmar un mensaje personal (requiere account/chain)

Tipos

getAccounts() devuelve AccountInfo[]. Las entradas de firma requieren la cuenta de Wallet Standard WalletAccount, cuyo campo publicKey es una matriz de bytes y que también incluye chains y features. Obtenla mediante standard:connect; no conviertas AccountInfo a WalletAccount.

import type { WalletAccount, IdentifierString } from '@mysten/wallet-standard'
import type { Transaction } from '@mysten/sui/transactions'
 
// provider.getAccounts()
interface AccountInfo {
  address: string
  publicKey: string // Hex-encoded public key
}
 
interface SignAndExecuteTransactionBlockInput {
  account: WalletAccount
  chain: IdentifierString
  transactionBlock: Transaction
  options?: {
    showEffects?: boolean
    showEvents?: boolean
    showObjectChanges?: boolean
    showBalanceChanges?: boolean
    showInput?: boolean
    showRawInput?: boolean
  }
}
 
interface SignTransactionBlockOutput {
  transactionBlockBytes: string
  signature: string
}
 
interface SignPersonalMessageInput {
  account: WalletAccount
  chain?: IdentifierString
  message: Uint8Array
}
 
interface SignPersonalMessageOutput {
  signature: string
  bytes: string
}

Cadenas compatibles

CadenaIdentificador
Red principalsui:mainnet
Red de pruebassui:testnet
Red de desarrollosui:devnet

Gestión de errores

try {
  await provider.requestPermissions()
} catch (error) {
  if (error.code === 4001) {
    console.log('User rejected the connection request')
  } else {
    console.error('Connection error:', error.message)
  }
}

Códigos de error habituales

CódigoDescripción
4001El usuario rechazó la solicitud
4100Sin autorización
-32603Error interno

Uso con Sui Wallet Kit

Este ejemplo de React usa las versiones compatibles de los paquetes fijadas a continuación:

npm install @mysten/[email protected] @mysten/[email protected] @tanstack/react-query@^5
import { SuiClientProvider, WalletProvider } from '@mysten/dapp-kit'
import { getFullnodeUrl } from '@mysten/sui/client'
import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
 
const queryClient = new QueryClient()
const networks = {
  mainnet: { url: getFullnodeUrl('mainnet') },
  testnet: { url: getFullnodeUrl('testnet') },
}
 
function App() {
  return (
    <QueryClientProvider client={queryClient}>
      <SuiClientProvider networks={networks} defaultNetwork="mainnet">
        <WalletProvider>
          <YourApp />
        </WalletProvider>
      </SuiClientProvider>
    </QueryClientProvider>
  )
}

OneKey se detecta automáticamente mediante Sui Wallet Standard.

Uso con Sui SDK

import { SuiClient } from '@mysten/sui/client'
 
const client = new SuiClient({ url: 'https://fullnode.mainnet.sui.io' })
 
// Get balance
const balance = await client.getBalance({
  owner: accountAddress,
})
 
// Get objects
const objects = await client.getOwnedObjects({
  owner: accountAddress,
})
 
// Get transaction
const txn = await client.getTransactionBlock({
  digest: txDigest,
  options: { showEffects: true },
})
Última actualización el
Referencia de la APIPrimeros pasos