SDK Methods

import { ActionCodesClient } from '@actioncodes/sdk'

const client = new ActionCodesClient({
  authToken: process.env.ACTION_CODES_TOKEN
})

const actionCode = await client.resolve(code)

const actionCode = await client.resolve('48291037')

console.log('Wallet:', actionCode.pubkey)
console.log('Expires:', new Date(actionCode.expiresAt))
console.log('Status:', actionCode.status)

const status = await client.getStatus(code)

const status = await client.getStatus('48291037')

if (status.finalizedSignature) {
  console.log('Transaction signed:', status.finalizedSignature)
}

for await (const status of client.observeStatus(code, options)) {
  // Handle status updates
}

for await (const status of client.observeStatus('48291037', { interval: 1000 })) {
  console.log('Status:', status.status)

  if (status.finalizedSignature) {
    console.log('Done! Signature:', status.finalizedSignature)
    break
  }

  if (status.signedMessage) {
    console.log('Done! Signed message:', status.signedMessage)
    break
  }

  if (status.status === 'expired') {
    console.log('Code expired')
    break
  }
}

await client.attachTransaction(code, transaction, meta?)

import { Transaction, SystemProgram, PublicKey, Connection } from '@solana/web3.js'

// Build the transaction
const connection = new Connection('https://api.mainnet-beta.solana.com')
const { blockhash } = await connection.getLatestBlockhash()

const tx = new Transaction({
  recentBlockhash: blockhash,
  feePayer: new PublicKey(actionCode.pubkey)
}).add(
  SystemProgram.transfer({
    fromPubkey: new PublicKey(actionCode.pubkey),
    toPubkey: new PublicKey(recipient),
    lamports: amount
  })
)

// Serialize (without signatures) and attach
const serialized = tx.serialize({ requireAllSignatures: false }).toString('base64')

await client.attachTransaction(code, serialized, {
  description: 'Transfer 0.1 SOL'
})

await client.attachMessage(code, message, meta?)

await client.attachMessage(code, 'Sign in to MyApp at ' + Date.now(), {
  description: 'Sign-in verification'
})

await client.finalizeTransaction(code, signature)

await client.finalizeMessage(code, signedMessage)

const actionCode = await client.register(pubkey, sign, metadata?)

import { PublicKey } from '@solana/web3.js'

const actionCode = await client.register(
  new PublicKey(walletAddress),
  async (message) => {
    // Sign with your wallet
    return wallet.signMessage(message)
  },
  { description: 'My action code' }
)

console.log('Generated code:', actionCode.code)

import {
  CodeNotFoundError,
  ExpiredCodeError,
  InvalidCodeFormatError,
  UnauthorizedError
} from '@actioncodes/sdk'

try {
  await client.resolve(code)
} catch (error) {
  if (error instanceof CodeNotFoundError) {
    console.log('Code does not exist')
  } else if (error instanceof ExpiredCodeError) {
    console.log('Code has expired')
  } else if (error instanceof InvalidCodeFormatError) {
    console.log('Invalid code format (must be 8 digits)')
  }
}

interface ActionCodeMeta {
  description?: string  // Human-readable description
  label?: string        // Short label
  memo?: string         // Additional memo
}

interface ActionCodeStatusResponse {
  status: 'pending' | 'attached' | 'finalized' | 'expired'
  expiresAt: number
  hasTransaction: boolean
  hasMessage: boolean
  finalizedSignature?: string
  signedMessage?: string
}

interface ObserveStatusOptions {
  interval?: number   // Polling interval in ms (default: 2000)
  timeout?: number    // Max observation time in ms (default: 120000)
}