1---
2title: Surfpool Cheatcodes
3description: Full reference for all surfnet_* RPC methods to manipulate time, accounts, and programs in a local Surfpool network during testing.
4---
5 
6# Surfpool Cheatcodes Reference
7 
8All `surfnet_*` JSON-RPC methods available on the surfnet RPC endpoint (default `http://127.0.0.1:8899`).
9 
10## Account Manipulation
11 
12| Method | Description |
13|---|---|
14| `surfnet_setAccount` | Set or update an account's lamports, data, owner, and executable status directly without transactions. |
15| `surfnet_setTokenAccount` | Set or update an SPL token account's balance, delegate, state, and close authority for any mint. |
16| `surfnet_resetAccount` | Reset an account to its original state from the remote datasource. Optionally cascades to owned accounts. |
17| `surfnet_streamAccount` | Register an account for live streaming — re-fetches from remote datasource on every access instead of caching. |
18| `surfnet_getStreamedAccounts` | List all accounts currently registered for streaming. |
19 
20## Program Management
21 
22| Method | Description |
23|---|---|
24| `surfnet_cloneProgramAccount` | Clone a program and its program data account from one address to another. Useful for forking programs. |
25| `surfnet_setProgramAuthority` | Change or remove the upgrade authority on a program's ProgramData account. |
26| `surfnet_writeProgram` | Deploy program data in chunks at a byte offset, bypassing transaction size limits (up to 5MB RPC limit). |
27| `surfnet_registerIdl` | Register an Anchor IDL for a program in memory, enabling parsed account data in responses. |
28| `surfnet_getActiveIdl` | Retrieve the registered IDL for a program at a given slot. Returns null if none registered. |
29 
30## Time Control
31 
32| Method | Description |
33|---|---|
34| `surfnet_timeTravel` | Jump the network clock to a specific UNIX timestamp, slot, or epoch. Useful for testing time-dependent logic. |
35| `surfnet_pauseClock` | Freeze slot advancement and block production. Network stays at current slot until resumed. |
36| `surfnet_resumeClock` | Resume slot advancement and block production after a pause. |
37 
38## Transaction Profiling
39 
40| Method | Description |
41|---|---|
42| `surfnet_profileTransaction` | Dry-run a transaction and return CU estimates, logs, errors, and before/after account state snapshots. |
43| `surfnet_getTransactionProfile` | Retrieve a stored transaction profile by signature or UUID. |
44| `surfnet_getProfileResultsByTag` | Retrieve all profiling results grouped under a tag. Useful for benchmarking test suites. |
45 
46## Network State
47 
48| Method | Description |
49|---|---|
50| `surfnet_setSupply` | Override what `getSupply` returns — total, circulating, and non-circulating amounts. |
51| `surfnet_resetNetwork` | Reset the entire network to its initial state. All accounts revert to their original remote state. |
52| `surfnet_getLocalSignatures` | Get recent transaction signatures with logs and errors. Defaults to last 50. |
53| `surfnet_getSurfnetInfo` | Get network info including runbook execution status and configuration. |
54| `surfnet_exportSnapshot` | Export all account state as JSON. Reload with `surfpool start --snapshot ./export.json`. |
55 
56## Scenarios
57 
58| Method | Description |
59|---|---|
60| `surfnet_registerScenario` | Register a scenario with timed account overrides using templates (e.g. Pyth price feeds, Raydium pools). |
61 
62---
63 
64## Surfpool MCP Server
65 
66For MCP server setup, available tools, resources, and agent workflows, see the [MCP Integration section in overview.md](overview.md#mcp-integration).
67