← The evidence ledger
Evidence row 570120
Observed , by probe.mcp/1.
- Kind
- mcp.tools
- About
- endpoint a24e71a4-27b0-4710-8bc2-6ec190343308
- Recorded
- Previous row
- None: the first of its kind about this subject
- Body SHA-256
- 7befd59ec71e1832a99a11000365a2be5cee187112f3b325df43dea1071baab0
- Leaf
- 0x282a8230414e1fd4356f900300486e24b9ead291777021c48afd766cfb7f4004
What was observed
{
"count": 6,
"tools": [
{
"description": "Buy the full report for one wallet and tax year ($29 up to 500 events, $59 up to 5,000, $99 above; upgrades charge the difference). method \"card\" charges the account owner's saved card: needs Authorization: Bearer ptx_… and the owner's opt-in; set max_price_cents to cap it. method \"usdc\" returns a quote: send exactly that USDC amount on HyperEVM (chain 999) to the given address, then call again with quote_id and tx_hash. (x402 clients can instead pay in USDC on Base or Solana at GET https://papertax.xyz/api/buy?address=…&year=….) Returns an unlock_token and export links. This spends money: confirm with the user first.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"address": {
"description": "Public Hyperliquid wallet address",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"max_price_cents": {
"description": "Card only: refuse if the price is higher than this",
"minimum": 0,
"type": "integer"
},
"method": {
"default": "card",
"enum": [
"card",
"usdc"
],
"type": "string"
},
"quote_id": {
"description": "USDC step 2: the quote_id from step 1",
"type": "string"
},
"tax_year": {
"description": "Tax year. AU-2027 = Australia · FY 2026–27; AU-2026 = Australia · FY 2025–26; US-2026 = United States · 2026; US-2025 = United States · 2025; UK-2027 = United Kingdom · 2026–27; UK-2026 = United Kingdom · 2025–26; CA-2026 = Canada · 2026; CA-2025 = Canada · 2025; NZ-2027 = New Zealand · 2026–27; NZ-2026 = New Zealand · 2025–26; JP-2026 = Japan · 2026; JP-2025 = Japan · 2025; ES-2026 = Spain · 2026; ES-2025 = Spain · 2025. Defaults by jurisdiction: AU AU-2026, US US-2026, UK UK-2026, CA CA-2026, NZ NZ-2027, JP JP-2026, ES ES-2026.",
"enum": [
"AU-2027",
"AU-2026",
"US-2026",
"US-2025",
"UK-2027",
"UK-2026",
"CA-2026",
"CA-2025",
"NZ-2027",
"NZ-2026",
"JP-2026",
"JP-2025",
"ES-2026",
"ES-2025"
],
"type": "string"
},
"tx_hash": {
"description": "USDC step 2: the HyperEVM transaction hash of the transfer",
"type": "string"
}
},
"type": "object"
},
"name": "buy_report"
},
{
"description": "Read a wallet's results for one tax year from the chain and return a public, signed link (https://papertax.xyz/v/…) with a share image, for posting on X or anywhere else. Free, and nothing is stored. Dollar amounts are included only when amounts is true. With private true (the default) the wallet address is left out of the link and the page; with private false the page shows it, so check with the user first. It proves what the wallet did, not who owns it.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"address": {
"description": "Public Hyperliquid wallet address",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"amounts": {
"default": false,
"description": "Include net result, gains, losses and fees",
"type": "boolean"
},
"jurisdiction": {
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US, CA, JP and ES = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ",
"JP",
"ES"
],
"type": "string"
},
"private": {
"default": true,
"description": "Leave the wallet address out of the link and page",
"type": "boolean"
},
"tax_year": {
"description": "Tax year. AU-2027 = Australia · FY 2026–27; AU-2026 = Australia · FY 2025–26; US-2026 = United States · 2026; US-2025 = United States · 2025; UK-2027 = United Kingdom · 2026–27; UK-2026 = United Kingdom · 2025–26; CA-2026 = Canada · 2026; CA-2025 = Canada · 2025; NZ-2027 = New Zealand · 2026–27; NZ-2026 = New Zealand · 2025–26; JP-2026 = Japan · 2026; JP-2025 = Japan · 2025; ES-2026 = Spain · 2026; ES-2025 = Spain · 2025. Defaults by jurisdiction: AU AU-2026, US US-2026, UK UK-2026, CA CA-2026, NZ NZ-2027, JP JP-2026, ES ES-2026.",
"enum": [
"AU-2027",
"AU-2026",
"US-2026",
"US-2025",
"UK-2027",
"UK-2026",
"CA-2026",
"CA-2025",
"NZ-2027",
"NZ-2026",
"JP-2026",
"JP-2025",
"ES-2026",
"ES-2025"
],
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "create_verified_pnl"
},
{
"description": "papertax's default treatment notes for Australia, the US, the UK, Canada, New Zealand, Japan or Spain, optionally for one event type. Not tax advice.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"event_type": {
"enum": [
"loss",
"liq",
"gain",
"queued",
"funding",
"mint",
"stakepay",
"spotgain",
"spotloss",
"vaultgain",
"vaultloss",
"income",
"airdrop",
"xfer",
"evmswap",
"defiin",
"defiout",
"receive",
"loan",
"unknown"
],
"type": "string"
},
"jurisdiction": {
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US, CA, JP and ES = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ",
"JP",
"ES"
],
"type": "string"
}
},
"type": "object"
},
"name": "explain_tax_treatment"
},
{
"description": "Koinly universal CSV, Crypto Tax Calculator advanced CSV, Cryptact custom file (JST, priced in yen by Cryptact), plain-text accountant summary, or the audit pack (audit = JSON with every figure tied to its transaction hash, a rules version and a data fingerprint; auditpdf = the printable PDF). Live wallets need paid access (API key or paid report). Large files are cut short with a download link.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"address": {
"description": "Public Hyperliquid wallet address",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"format": {
"default": "koinly",
"enum": [
"koinly",
"ctc",
"cryptact",
"summary",
"audit",
"auditpdf"
],
"type": "string"
},
"jurisdiction": {
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US, CA, JP and ES = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ",
"JP",
"ES"
],
"type": "string"
},
"sample": {
"default": false,
"description": "Return deterministic sample data instead of reading Hyperliquid",
"type": "boolean"
},
"save_wallet": {
"default": false,
"description": "With a Trader or Accountant plan API key: add this wallet to the plan if it is not on it yet (uses one of the plan's 10 wallets or a client seat). Without it, a wallet not on the plan gets the preview and a note.",
"type": "boolean"
},
"tax_year": {
"description": "Tax year. AU-2027 = Australia · FY 2026–27; AU-2026 = Australia · FY 2025–26; US-2026 = United States · 2026; US-2025 = United States · 2025; UK-2027 = United Kingdom · 2026–27; UK-2026 = United Kingdom · 2025–26; CA-2026 = Canada · 2026; CA-2025 = Canada · 2025; NZ-2027 = New Zealand · 2026–27; NZ-2026 = New Zealand · 2025–26; JP-2026 = Japan · 2026; JP-2025 = Japan · 2025; ES-2026 = Spain · 2026; ES-2025 = Spain · 2025. Defaults by jurisdiction: AU AU-2026, US US-2026, UK UK-2026, CA CA-2026, NZ NZ-2027, JP JP-2026, ES ES-2026.",
"enum": [
"AU-2027",
"AU-2026",
"US-2026",
"US-2025",
"UK-2027",
"UK-2026",
"CA-2026",
"CA-2025",
"NZ-2027",
"NZ-2026",
"JP-2026",
"JP-2025",
"ES-2026",
"ES-2025"
],
"type": "string"
},
"trade_history_account": {
"description": "Optional: the subaccount address the trade history file belongs to (from coverage.subaccounts). Omit for the main account's file.",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"trade_history_csv": {
"description": "Optional: the text of a trade history CSV the user exported from Hyperliquid (Trade History, Export as CSV). Hyperliquid's API serves only about a wallet's most recent 10,000 fills, so for very active wallets this adds the older trades; only trades the API didn't return are added. Nothing is stored.",
"maxLength": 4000000,
"type": "string"
},
"unlock_token": {
"description": "Unlock token returned by buy_report (or the website after paying), for wallets bought without an API key",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "export_tax_file"
},
{
"description": "Individual ledger rows with default tax classification: perp opens, closes, liquidations and funding (main account and subaccounts); spot and HIP-4 outcome buys and sells; vault deposits and withdrawals; staking rewards; HyperEVM swaps, protocol deposits, loans and liquidity positions; transfers; papertrade mints and staking; anything unrecognised, flagged for review. Filter by event type or venue. Without paid access, live wallets return the first 10 rows.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"address": {
"description": "Public Hyperliquid wallet address",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"jurisdiction": {
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US, CA, JP and ES = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ",
"JP",
"ES"
],
"type": "string"
},
"limit": {
"default": 100,
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"sample": {
"default": false,
"description": "Return deterministic sample data instead of reading Hyperliquid",
"type": "boolean"
},
"save_wallet": {
"default": false,
"description": "With a Trader or Accountant plan API key: add this wallet to the plan if it is not on it yet (uses one of the plan's 10 wallets or a client seat). Without it, a wallet not on the plan gets the preview and a note.",
"type": "boolean"
},
"tax_year": {
"description": "Tax year. AU-2027 = Australia · FY 2026–27; AU-2026 = Australia · FY 2025–26; US-2026 = United States · 2026; US-2025 = United States · 2025; UK-2027 = United Kingdom · 2026–27; UK-2026 = United Kingdom · 2025–26; CA-2026 = Canada · 2026; CA-2025 = Canada · 2025; NZ-2027 = New Zealand · 2026–27; NZ-2026 = New Zealand · 2025–26; JP-2026 = Japan · 2026; JP-2025 = Japan · 2025; ES-2026 = Spain · 2026; ES-2025 = Spain · 2025. Defaults by jurisdiction: AU AU-2026, US US-2026, UK UK-2026, CA CA-2026, NZ NZ-2027, JP JP-2026, ES ES-2026.",
"enum": [
"AU-2027",
"AU-2026",
"US-2026",
"US-2025",
"UK-2027",
"UK-2026",
"CA-2026",
"CA-2025",
"NZ-2027",
"NZ-2026",
"JP-2026",
"JP-2025",
"ES-2026",
"ES-2025"
],
"type": "string"
},
"trade_history_account": {
"description": "Optional: the subaccount address the trade history file belongs to (from coverage.subaccounts). Omit for the main account's file.",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"trade_history_csv": {
"description": "Optional: the text of a trade history CSV the user exported from Hyperliquid (Trade History, Export as CSV). Hyperliquid's API serves only about a wallet's most recent 10,000 fills, so for very active wallets this adds the older trades; only trades the API didn't return are added. Nothing is stored.",
"maxLength": 4000000,
"type": "string"
},
"type": {
"enum": [
"open",
"loss",
"liq",
"gain",
"queued",
"funding",
"mint",
"stake",
"stakepay",
"spotbuy",
"spotgain",
"spotloss",
"vaultin",
"vaultgain",
"vaultloss",
"income",
"airdrop",
"xfer",
"evmswap",
"defiin",
"defiout",
"receive",
"loan",
"unknown"
],
"type": "string"
},
"unlock_token": {
"description": "Unlock token returned by buy_report (or the website after paying), for wallets bought without an API key",
"type": "string"
},
"venue": {
"description": "Venue key: hl (perps), hip3:<dex> (e.g. hip3:xyz), spot, outcome (HIP-4 outcome markets), vault, staking, evm (HyperEVM), pt (papertrade), fork, core (deposits and transfers); a subaccount's venues are sub:<address>:<venue>",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "get_ledger_events"
},
{
"description": "Free. Per-venue realised gains and losses, fees, funding, liquidations, open positions and items needing review for one wallet and tax year (subaccounts included automatically), plus trading analytics (fee and funding drag, liquidation review, net after costs by market and month). For live wallets, report gives the event count, the full report's price for this caller, whether they already have access, and how to buy it.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"address": {
"description": "Public Hyperliquid wallet address",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"jurisdiction": {
"default": "AU",
"description": "Used when tax_year is not given. AU = 1 Jul–30 Jun; US, CA, JP and ES = calendar year; UK = 6 Apr–5 Apr; NZ = 1 Apr–31 Mar",
"enum": [
"AU",
"US",
"UK",
"CA",
"NZ",
"JP",
"ES"
],
"type": "string"
},
"sample": {
"default": false,
"description": "Return deterministic sample data instead of reading Hyperliquid",
"type": "boolean"
},
"tax_year": {
"description": "Tax year. AU-2027 = Australia · FY 2026–27; AU-2026 = Australia · FY 2025–26; US-2026 = United States · 2026; US-2025 = United States · 2025; UK-2027 = United Kingdom · 2026–27; UK-2026 = United Kingdom · 2025–26; CA-2026 = Canada · 2026; CA-2025 = Canada · 2025; NZ-2027 = New Zealand · 2026–27; NZ-2026 = New Zealand · 2025–26; JP-2026 = Japan · 2026; JP-2025 = Japan · 2025; ES-2026 = Spain · 2026; ES-2025 = Spain · 2025. Defaults by jurisdiction: AU AU-2026, US US-2026, UK UK-2026, CA CA-2026, NZ NZ-2027, JP JP-2026, ES ES-2026.",
"enum": [
"AU-2027",
"AU-2026",
"US-2026",
"US-2025",
"UK-2027",
"UK-2026",
"CA-2026",
"CA-2025",
"NZ-2027",
"NZ-2026",
"JP-2026",
"JP-2025",
"ES-2026",
"ES-2025"
],
"type": "string"
},
"trade_history_account": {
"description": "Optional: the subaccount address the trade history file belongs to (from coverage.subaccounts). Omit for the main account's file.",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"trade_history_csv": {
"description": "Optional: the text of a trade history CSV the user exported from Hyperliquid (Trade History, Export as CSV). Hyperliquid's API serves only about a wallet's most recent 10,000 fills, so for very active wallets this adds the older trades; only trades the API didn't return are added. Nothing is stored.",
"maxLength": 4000000,
"type": "string"
},
"unlock_token": {
"description": "Unlock token returned by buy_report (or the website after paying), for wallets bought without an API key",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "get_tax_summary"
}
]
}What the leaf hashes
{"body":"7befd59ec71e1832a99a11000365a2be5cee187112f3b325df43dea1071baab0","id":570120,"kind":"mcp.tools","method":"probe.mcp/1","observed_us":1793139635920681,"prev":null,"subject":"a24e71a4-27b0-4710-8bc2-6ec190343308","subject_kind":"endpoint"}Proof
Fold these into the leaf in order, hashing each sorted pair with keccak256, to reach the root of (273461 rows).
- 0x282a0649d82955b5a48c3aa16bf62f64e02fe6ccfa433b4b7284c966943020ad
- 0x2e799e2bd8a5acbd00a552f21e8cd83de2c4080793c2d77a688e60fc28ee40e5
- 0x0b61a3788ec5d57ff80e72c16735a6b04fcd46af869a715ae462e943db2dd9ea
- 0x035d194c592afcb4b6570a72d2ee318969e14fa716c8c5194f92e8c4a1c067e6
- 0x18e61c8ddb21918ab45c2663fdd1d4f7f2bb89b1e870fd286fd620d32edf1f70
- 0x308d3e19b8cc4652dd277e2cd7061da850fc1c2b7d3848c5da563e90e92f3875
- 0x2126dd8cb1d2acb74a78c26b18070f0d810dc8b4856a4cbc13326d60d84f0119
- 0xe6782e28eb99803f8c5f979f4eb7f90bdf29a26080196c9589b01b4c36512c24
- 0xc79907d0216d59ebd5db126ab2d72e4bbd8de3cc91d43c9dfdf4d26431cebd79
- 0xcd7591a749947c5ef43cdb1c7160add06a4cbf7c9eb52798b70aec5b45c28b7e
- 0xbae4a65d8ae80540633da98a42bc7238b1aae389589d7285d2f85046a743e3a5
- 0xf5aa0adf486bca586314afc4935e732d521d3d8275e51eb4c8d2de46b00ea2c1
- 0x28be2f2303fcac4decdb6323b0f4ee8f8a31038beb758eaafc604a98626292e4
- 0x8ff18b1523f9fbdd16a5796cbe184b46854c06256508af8de5509b598370c725
- 0xa383a1cfe9b3f6af67eb4c7642564b9424d46d7fca90e7ba175d549f8b67dd0c
- 0x52efa60e0c3d8525486d2310eb3b6b566c9677c64fd1f819edb072cf101bcbdb
- 0x22c1fb9487ee0b9732fa017a0cc321eb27a60c08450d112f755089796e12cb1c
- 0xa20d48798a34aba12eb9c7297722982d910f06c148f5e27ac59307422964a585
- 0x9fc354c0ea3efc3f1b6548bb77ea902a50f2c9647647ea61592efce2bd795699
- Day root
- 0xdd77e5e99da32c3f154180d63e3c3e6fe11e896a2c6896412ef6b5c4bcf7e795
- Chained
- 0x23bb4dfd09f55c15ac3962f53578e02c6114d5bfd9bb451cf8794fb6e2817ef4
- Published
- On Arc Testnet, block 69414147: 0xb2ebd83aafeb765a0ce66e76aefb133ed06606c98038fd56191e2bcd1dcb77b4