typhoon-starknet-account

# 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

## Quick Reference
- Deep dives: `references/` (ABI discovery, Typhoon account flow, preflight/fee simulation notes)
- 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

```bash
npm install starknet@^9.2.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 v9.2.1 quick patterns

```js
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);
```

Common cal...