Skip to Content
dAppsSui
Auf dieser Seite

Sui

Die folgenden Signierbeispiele verwenden connectSuiAccount() aus Erste Schritte. Die Hilfsfunktion gibt ein Wallet-Standard-Konto und dessen aktive Chain zurück. Die Beispiele verwenden @mysten/[email protected]. Auch die älteren *TransactionBlock-Methoden deklarieren nun Transaction-Eingaben in @mysten/[email protected].

Integrieren Sie die Sui-Blockchain mit dem Provider von OneKey. Zugriff über window.$onekey.sui.

OneKey implementiert den Sui Wallet Standard für kompatible Wallet-Standard-Integrationen.

Provider erkennen

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

Schnellstart

Berechtigungen prüfen

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

Verbindung anfordern

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

Trennen

await provider.disconnect()

Kontoverwaltung

Konten abrufen

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

Aktive Chain abrufen

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

Transaktionen

Transaktionsblock signieren und ausführen

Der aktuelle injizierte Provider leitet options nicht weiter in signAndExecuteTransactionBlock. Fragen Sie den zurückgegebenen Digest mit einem Sui-Client auf derselben Chain ab, um Auswirkungen, Ereignisse oder Objektänderungen anzufordern.

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,
})

Transaktionsblock signieren (ohne Ausführung)

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,
// })

Transaktion signieren und ausführen (neue API)

// 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,
})

Transaktion signieren (neue API)

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,
})

Nachrichten signieren

Persönliche Nachricht signieren

Beliebige Nachrichten zur Authentifizierung signieren:

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
})

Nachricht signieren (Legacy)

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,
})

Signatur prüfen

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)

Smart-Contract-Interaktion

Move-Aufruf

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,
})

Paket veröffentlichen

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,
})

API-Referenz

Methoden

MethodeBeschreibung
hasPermissions()Prüfen, ob verbunden
requestPermissions()Verbindung anfordern
disconnect()Wallet trennen
getAccounts()Verbundene Konten abrufen (nur address und publicKey)
getActiveChain()Aktuelle Chain abrufen
signAndExecuteTransactionBlock(input)Signieren und ausführen, benötigt account/chain
signTransactionBlock(input)Nur signieren, benötigt account/chain
signAndExecuteTransaction(input)Signieren und ausführen (neue API, Transaction, benötigt account/chain)
signTransaction(input)Transaktion signieren (neue API, Transaction, benötigt account/chain)
signMessage(input)Nachricht signieren (Legacy, benötigt account)
signPersonalMessage(input)Persönliche Nachricht signieren (benötigt account/chain)

Typen

getAccounts() gibt AccountInfo[] zurück. Signiereingaben benötigen das Wallet-Standard-Objekt WalletAccount, dessen publicKey ein Byte-Array ist und das auch chains und features enthält. Rufen Sie es über standard:connect ab; wandeln Sie AccountInfo nicht per Typumwandlung in WalletAccount um.

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
}

Unterstützte Chains

ChainKennung
Mainnetsui:mainnet
Testnetsui:testnet
Devnetsui:devnet

Fehlerbehandlung

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

Häufige Fehlercodes

CodeBeschreibung
4001Nutzer hat die Anfrage abgelehnt
4100Nicht autorisiert
-32603Interner Fehler

Mit Sui Wallet Kit verwenden

Dieses React-Beispiel verwendet die unten festgelegten kompatiblen Paketversionen:

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 wird automatisch über den Sui Wallet Standard erkannt.

Mit dem Sui-SDK verwenden

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 },
})
Zuletzt aktualisiert am
API-ReferenzErste Schritte