starknet-anonymous-wallet

typhoon-starknet-account

This skill provides agent-facing scripts for:

• Creating/loading a Starknet account (Typhoon flow)
• Discovering ABI / functions
• Reading & writing to contracts
• Preflight (simulate + fee estimate)
• Allowance checks with human amounts

When to Use

• Creating or operating privacy-focused Starknet accounts through the Typhoon flow.
• Running agent-side contract reads, writes, preflight simulation, or allowance checks from an anonymous wallet context.

When NOT to Use

• Standard non-private wallet management, DeFi routing, or payment-link flows.
• Cairo contract authoring, deployment operations, or security audits.

Quick Start

• Deep dives: references/ (ABI discovery, Typhoon account flow, preflight/fee simulation notes)
• Adjacent modules: skills catalog
• Account flow examples: scripts/create-account.js, scripts/parse-smart.js, scripts/resolve-smart.js
• Read/write examples: scripts/read-smart.js, scripts/invoke-contract.js, scripts/avnu-swap.js
• Allowance checks example: scripts/read-smart.js (call ERC20 allowance(owner, spender))

Prerequisites

npm install starknet@^8.9.1 typhoon-sdk@^1.1.13 @andersmyrmel/vard@^1.2.0 @avnu/avnu-sdk compromise@^14.14.5 ws@^8.19.0

RPC setup (required for onchain reads/writes)

These scripts talk to Starknet via JSON-RPC. Configure one of:

• Set STARKNET_RPC_URL in your environment (recommended), OR
• Pass rpcUrl in the JSON input for scripts that support it.

If neither is provided, scripts fall back to the public Lava mainnet RPC:

• https://rpc.starknet.lava.build:443

Starknet.js v8.9.1 quick patterns

import { RpcProvider, Account, Contract } from 'starknet';

const provider = new RpcProvider({
  nodeUrl: process.env.STARKNET_RPC_URL || 'https://rpc.starknet.lava.build:443'
});

// signer can be a private key string or Starknet Signer instance
const account = new Account({
  provider,
  address: process.env.ACCOUNT_ADDRESS,
  signer: process.env.PRIVATE_KEY
});

const contract = new Contract({
  abi,
  address: contractAddress,
  providerOrAccount: account
});

// read
const balance = await contract.call('balance_of', [account.address]);

// write (sign -> send -> wait)
const tx = await contract.invoke('transfer', [to, amount], { waitForTransaction: false });
const receipt = await provider.waitForTransaction(tx.transaction_hash);