Quickstart

Create an EVM account for a crosschain transfer, or a Solana account for an SPL transfer. Select the same VM throughout; paste the shared blocks and selected examples into quickstart.ts in order.

Prerequisites

Run this example in a secure server-side environment. You need:

A RHINESTONE_API_KEY from the Rhinestone dashboard
For EVM, a funding account with Base Sepolia ETH and its private key in FUNDING_PRIVATE_KEY
For Solana, configured deployment sponsorship and devnet USDC to fund the wallet after deployment

Get Base Sepolia ETH from the QuickNode faucet or Alchemy faucet. Keep private keys and the API key private. Solana network and route availability depend on your environment; SDK support does not guarantee a live route. See Solana support.

This guide targets SDK 3.0.0, which is not released yet. The install commands below are for use after publication.

Install the SDK and its compatible viem peer:

npm install viem@^2.55.0 @rhinestone/sdk@3.0.0 && npm install --save-dev tsx @types/node

pnpm add viem@^2.55.0 @rhinestone/sdk@3.0.0 && pnpm add --save-dev tsx @types/node

bun add viem@^2.55.0 @rhinestone/sdk@3.0.0 && bun add --dev tsx @types/node

Initialize the SDK once for either VM:

import { RhinestoneSDK } from '@rhinestone/sdk'
import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts'

const apiKey = process.env.RHINESTONE_API_KEY
if (!apiKey) throw new Error('RHINESTONE_API_KEY is required')
const ownerPrivateKey = generatePrivateKey()
const owner = privateKeyToAccount(ownerPrivateKey)
const rhinestone = new RhinestoneSDK({
  auth: { mode: 'apiKey', apiKey },
})

Store ownerPrivateKey securely before funding either account; this generated example key is not recoverable after the script exits.

Create an account

Create an account controlled by the owner above. This computes its address without deploying it.

Fund the account

Fund the account’s wallet address with enough testnet assets for the transfer and quoted fees.See Account deployment for readiness checks before funding.

Prepare and send a transaction

Prepare a transfer of 0.1 USDC. Review the selected quote before signing.Use the same signing and submission lifecycle for either VM:

const signed = await account.signTransaction(prepared)
const submitted = await account.submitTransaction(signed)
const result = await account.waitForExecution(submitted)

console.log('Result:', result)

submitTransaction returns an intent handle. waitForExecution waits for a terminal outcome: it resolves on success and throws on failure. Keep the submitted intent ID so you can inspect its status before retrying.

Run the completed script:

npx tsx quickstart.ts

Expected outcome

On successful execution, the result has the status COMPLETED. The EVM recipe deploys the account on Base Sepolia and Arbitrum Sepolia and transfers 0.1 USDC on Arbitrum Sepolia. The Solana recipe transfers 0.1 devnet USDC from the deployed wallet.

Next steps

Configure the account

Choose an owner and account implementation.

Send another transaction

Learn the complete multichain transaction flow.

Sponsor fees

Cover selected transaction costs for your users.

Account setup

Recovery

Signing

Configuration

Integration

SDK reference

Prerequisites

Expected outcome

Next steps

Configure the account

Send another transaction

Sponsor fees

​Prerequisites

​Expected outcome

​Next steps

Configure the account

Send another transaction

Sponsor fees

Prerequisites

Expected outcome

Next steps