{"openapi":"3.1.0","info":{"title":"Aztec Scan API","version":"prod-8099ac4a291c","description":"API for exploring Aztec Network. Please note that this is a work in progress and the API is subject to change.\n\nCurrently there is no sign-up process for an API key. There will however be rate limits in place.\n\nThis is also subject to change, and the latest updates on this will always be available here.\n\nExperimental SDK can be found here: [aztec-scan-sdk](https://github.com/aztec-scan/aztec-scan-sdk)","contact":{"name":"Github","url":"https://github.com/aztec-scan/chicmoz"}},"servers":[{"url":"https://api.aztecscan.xyz/v1/{apiKey}","description":"Mainnet Aztecscan API","variables":{"apiKey":{"default":"temporary-api-key","description":"Aztecscan API key"}}},{"url":"https://api.mainnet.aztecscan.xyz/v1/{apiKey}","description":"Mainnet Aztecscan API alias","variables":{"apiKey":{"default":"temporary-api-key","description":"Aztecscan API key"}}},{"url":"https://api.testnet.aztecscan.xyz/v1/{apiKey}","description":"Testnet Aztecscan API","variables":{"apiKey":{"default":"temporary-api-key","description":"Aztecscan API key"}}},{"url":"https://api.devnet.aztecscan.xyz/v1/{apiKey}","description":"Devnet Aztecscan API","variables":{"apiKey":{"default":"temporary-api-key","description":"Aztecscan API key"}}}],"externalDocs":{"description":"Experimental Aztec Scan SDK","url":"https://github.com/aztec-scan/aztec-scan-sdk"},"paths":{"/l2/latest-height":{"get":{"tags":["L2","blocks"],"summary":"Get the latest block height","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"integer"}}}}}}},"/l2/blocks/latest":{"get":{"tags":["L2","blocks"],"summary":"Get the latest block","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"hash":{},"height":{"type":["string"]},"nativeStatus":{"type":["string"],"enum":["proposed","checkpointed","proven","finalized","unknown"],"description":"Product-facing Aztec-native block status derived from current L2 tips. `checkpointed` is a native L2 tip bucket; on Aztec v4, upstream `finalized` may equal `proven`."},"proposedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"archive":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","archive"]},"proofVerifiedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"proverId":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","proverId"]},"orphan":{"type":["object"],"properties":{"timestamp":{"type":["number"]},"hasOrphanedParent":{"type":["boolean"]}},"required":["timestamp","hasOrphanedParent"]},"archive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"header":{"type":["object"],"properties":{"lastArchive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"spongeBlobHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"state":{"type":["object"],"properties":{"l1ToL2MessageTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"partial":{"type":["object"],"properties":{"noteHashTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"nullifierTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"publicDataTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]}},"required":["noteHashTree","nullifierTree","publicDataTree"]}},"required":["l1ToL2MessageTree","partial"]},"globalVariables":{"type":["object"],"properties":{"chainId":{"type":["integer"],"minimum":0},"version":{"type":["integer"],"minimum":0},"blockNumber":{"type":["integer"],"minimum":0},"slotNumber":{"type":["integer"],"minimum":0},"timestamp":{"type":["integer"],"minimum":0},"coinbase":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"feeRecipient":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"gasFees":{"type":["object"],"properties":{"feePerDaGas":{"type":["string"],"pattern":"^\\d+$"},"feePerL2Gas":{"type":["string"],"pattern":"^\\d+$"}},"required":["feePerDaGas","feePerL2Gas"]}},"required":["chainId","version","blockNumber","slotNumber","timestamp","coinbase","feeRecipient","gasFees"]},"totalFees":{"type":["string"]},"totalManaUsed":{"type":["string"]}},"required":["lastArchive","spongeBlobHash","state","globalVariables","totalFees","totalManaUsed"]},"body":{"type":["object"],"properties":{"txEffects":{"type":["array"],"items":{"type":["object"],"properties":{"txHash":{}},"required":["txHash"]}}},"required":["txEffects"]}},"required":["hash","height","archive","header","body"]}}}}}}},"/l2/blocks/{heightOrHash}":{"get":{"tags":["L2","blocks"],"summary":"Get a block by height or hash","parameters":[{"name":"heightOrHash","in":"path","required":true,"schema":{"oneOf":[{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},{"type":"integer"}]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"hash":{},"height":{"type":["string"]},"nativeStatus":{"type":["string"],"enum":["proposed","checkpointed","proven","finalized","unknown"],"description":"Product-facing Aztec-native block status derived from current L2 tips. `checkpointed` is a native L2 tip bucket; on Aztec v4, upstream `finalized` may equal `proven`."},"proposedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"archive":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","archive"]},"proofVerifiedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"proverId":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","proverId"]},"orphan":{"type":["object"],"properties":{"timestamp":{"type":["number"]},"hasOrphanedParent":{"type":["boolean"]}},"required":["timestamp","hasOrphanedParent"]},"archive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"header":{"type":["object"],"properties":{"lastArchive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"spongeBlobHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"state":{"type":["object"],"properties":{"l1ToL2MessageTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"partial":{"type":["object"],"properties":{"noteHashTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"nullifierTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"publicDataTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]}},"required":["noteHashTree","nullifierTree","publicDataTree"]}},"required":["l1ToL2MessageTree","partial"]},"globalVariables":{"type":["object"],"properties":{"chainId":{"type":["integer"],"minimum":0},"version":{"type":["integer"],"minimum":0},"blockNumber":{"type":["integer"],"minimum":0},"slotNumber":{"type":["integer"],"minimum":0},"timestamp":{"type":["integer"],"minimum":0},"coinbase":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"feeRecipient":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"gasFees":{"type":["object"],"properties":{"feePerDaGas":{"type":["string"],"pattern":"^\\d+$"},"feePerL2Gas":{"type":["string"],"pattern":"^\\d+$"}},"required":["feePerDaGas","feePerL2Gas"]}},"required":["chainId","version","blockNumber","slotNumber","timestamp","coinbase","feeRecipient","gasFees"]},"totalFees":{"type":["string"]},"totalManaUsed":{"type":["string"]}},"required":["lastArchive","spongeBlobHash","state","globalVariables","totalFees","totalManaUsed"]},"body":{"type":["object"],"properties":{"txEffects":{"type":["array"],"items":{"type":["object"],"properties":{"txHash":{}},"required":["txHash"]}}},"required":["txEffects"]}},"required":["hash","height","archive","header","body"]}}}}}}},"/l2/blocks":{"get":{"tags":["L2","blocks"],"summary":"Get multiple blocks","parameters":[{"name":"from","in":"query","schema":{"type":"integer"}},{"name":"to","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"hash":{},"height":{"type":["string"]},"nativeStatus":{"type":["string"],"enum":["proposed","checkpointed","proven","finalized","unknown"],"description":"Product-facing Aztec-native block status derived from current L2 tips. `checkpointed` is a native L2 tip bucket; on Aztec v4, upstream `finalized` may equal `proven`."},"proposedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"archive":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","archive"]},"proofVerifiedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"proverId":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","proverId"]},"orphan":{"type":["object"],"properties":{"timestamp":{"type":["number"]},"hasOrphanedParent":{"type":["boolean"]}},"required":["timestamp","hasOrphanedParent"]},"archive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"header":{"type":["object"],"properties":{"lastArchive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"spongeBlobHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"state":{"type":["object"],"properties":{"l1ToL2MessageTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"partial":{"type":["object"],"properties":{"noteHashTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"nullifierTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"publicDataTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]}},"required":["noteHashTree","nullifierTree","publicDataTree"]}},"required":["l1ToL2MessageTree","partial"]},"globalVariables":{"type":["object"],"properties":{"chainId":{"type":["integer"],"minimum":0},"version":{"type":["integer"],"minimum":0},"blockNumber":{"type":["integer"],"minimum":0},"slotNumber":{"type":["integer"],"minimum":0},"timestamp":{"type":["integer"],"minimum":0},"coinbase":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"feeRecipient":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"gasFees":{"type":["object"],"properties":{"feePerDaGas":{"type":["string"],"pattern":"^\\d+$"},"feePerL2Gas":{"type":["string"],"pattern":"^\\d+$"}},"required":["feePerDaGas","feePerL2Gas"]}},"required":["chainId","version","blockNumber","slotNumber","timestamp","coinbase","feeRecipient","gasFees"]},"totalFees":{"type":["string"]},"totalManaUsed":{"type":["string"]}},"required":["lastArchive","spongeBlobHash","state","globalVariables","totalFees","totalManaUsed"]},"body":{"type":["object"],"properties":{"txEffects":{"type":["array"],"items":{"type":["object"],"properties":{"txHash":{}},"required":["txHash"]}}},"required":["txEffects"]}},"required":["hash","height","archive","header","body"]}}}}}}}},"/l2/blocks/by-status":{"get":{"tags":["L2","blocks"],"summary":"Get representative blocks for native L2 status buckets","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"hash":{},"height":{"type":["string"]},"nativeStatus":{"type":["string"],"enum":["proposed","checkpointed","proven","finalized","unknown"],"description":"Product-facing Aztec-native block status derived from current L2 tips. `checkpointed` is a native L2 tip bucket; on Aztec v4, upstream `finalized` may equal `proven`."},"proposedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"archive":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","archive"]},"proofVerifiedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"proverId":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","proverId"]},"orphan":{"type":["object"],"properties":{"timestamp":{"type":["number"]},"hasOrphanedParent":{"type":["boolean"]}},"required":["timestamp","hasOrphanedParent"]},"archive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"header":{"type":["object"],"properties":{"lastArchive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"spongeBlobHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"state":{"type":["object"],"properties":{"l1ToL2MessageTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"partial":{"type":["object"],"properties":{"noteHashTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"nullifierTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"publicDataTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]}},"required":["noteHashTree","nullifierTree","publicDataTree"]}},"required":["l1ToL2MessageTree","partial"]},"globalVariables":{"type":["object"],"properties":{"chainId":{"type":["integer"],"minimum":0},"version":{"type":["integer"],"minimum":0},"blockNumber":{"type":["integer"],"minimum":0},"slotNumber":{"type":["integer"],"minimum":0},"timestamp":{"type":["integer"],"minimum":0},"coinbase":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"feeRecipient":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"gasFees":{"type":["object"],"properties":{"feePerDaGas":{"type":["string"],"pattern":"^\\d+$"},"feePerL2Gas":{"type":["string"],"pattern":"^\\d+$"}},"required":["feePerDaGas","feePerL2Gas"]}},"required":["chainId","version","blockNumber","slotNumber","timestamp","coinbase","feeRecipient","gasFees"]},"totalFees":{"type":["string"]},"totalManaUsed":{"type":["string"]}},"required":["lastArchive","spongeBlobHash","state","globalVariables","totalFees","totalManaUsed"]},"body":{"type":["object"],"properties":{"txEffects":{"type":["array"],"items":{"type":["object"],"properties":{"txHash":{}},"required":["txHash"]}}},"required":["txEffects"]}},"required":["hash","height","archive","header","body"]}}}}}}}},"/l2/blocks/orphaned":{"get":{"tags":["L2","blocks"],"summary":"Get all orphaned blocks","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"hash":{},"height":{"type":["string"]},"nativeStatus":{"type":["string"],"enum":["proposed","checkpointed","proven","finalized","unknown"],"description":"Product-facing Aztec-native block status derived from current L2 tips. `checkpointed` is a native L2 tip bucket; on Aztec v4, upstream `finalized` may equal `proven`."},"proposedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"archive":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","archive"]},"proofVerifiedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"proverId":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","proverId"]},"orphan":{"type":["object"],"properties":{"timestamp":{"type":["number"]},"hasOrphanedParent":{"type":["boolean"]}},"required":["timestamp","hasOrphanedParent"]},"archive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"header":{"type":["object"],"properties":{"lastArchive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"spongeBlobHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"state":{"type":["object"],"properties":{"l1ToL2MessageTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"partial":{"type":["object"],"properties":{"noteHashTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"nullifierTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"publicDataTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]}},"required":["noteHashTree","nullifierTree","publicDataTree"]}},"required":["l1ToL2MessageTree","partial"]},"globalVariables":{"type":["object"],"properties":{"chainId":{"type":["integer"],"minimum":0},"version":{"type":["integer"],"minimum":0},"blockNumber":{"type":["integer"],"minimum":0},"slotNumber":{"type":["integer"],"minimum":0},"timestamp":{"type":["integer"],"minimum":0},"coinbase":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"feeRecipient":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"gasFees":{"type":["object"],"properties":{"feePerDaGas":{"type":["string"],"pattern":"^\\d+$"},"feePerL2Gas":{"type":["string"],"pattern":"^\\d+$"}},"required":["feePerDaGas","feePerL2Gas"]}},"required":["chainId","version","blockNumber","slotNumber","timestamp","coinbase","feeRecipient","gasFees"]},"totalFees":{"type":["string"]},"totalManaUsed":{"type":["string"]}},"required":["lastArchive","spongeBlobHash","state","globalVariables","totalFees","totalManaUsed"]},"body":{"type":["object"],"properties":{"txEffects":{"type":["array"],"items":{"type":["object"],"properties":{"txHash":{}},"required":["txHash"]}}},"required":["txEffects"]}},"required":["hash","height","archive","header","body"]}}}}}}}},"/l2/blocks/orphans":{"get":{"tags":["L2","blocks"],"summary":"Get the last 100 orphaned blocks","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"hash":{},"height":{"type":["string"]},"nativeStatus":{"type":["string"],"enum":["proposed","checkpointed","proven","finalized","unknown"],"description":"Product-facing Aztec-native block status derived from current L2 tips. `checkpointed` is a native L2 tip bucket; on Aztec v4, upstream `finalized` may equal `proven`."},"proposedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"archive":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","archive"]},"proofVerifiedOnL1":{"type":["object"],"properties":{"l1ContractAddress":{"type":["string"]},"l1BlockNumber":{"type":["string"]},"l1BlockTimestamp":{"type":["number","null"]},"l1BlockHash":{"type":["string"]},"isFinalized":{"type":["boolean"]},"proverId":{"type":["string"]}},"required":["l1ContractAddress","l1BlockNumber","l1BlockHash","isFinalized","proverId"]},"orphan":{"type":["object"],"properties":{"timestamp":{"type":["number"]},"hasOrphanedParent":{"type":["boolean"]}},"required":["timestamp","hasOrphanedParent"]},"archive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"header":{"type":["object"],"properties":{"lastArchive":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"spongeBlobHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"state":{"type":["object"],"properties":{"l1ToL2MessageTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"partial":{"type":["object"],"properties":{"noteHashTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"nullifierTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]},"publicDataTree":{"type":["object"],"properties":{"root":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"nextAvailableLeafIndex":{"type":["number"]}},"required":["root","nextAvailableLeafIndex"]}},"required":["noteHashTree","nullifierTree","publicDataTree"]}},"required":["l1ToL2MessageTree","partial"]},"globalVariables":{"type":["object"],"properties":{"chainId":{"type":["integer"],"minimum":0},"version":{"type":["integer"],"minimum":0},"blockNumber":{"type":["integer"],"minimum":0},"slotNumber":{"type":["integer"],"minimum":0},"timestamp":{"type":["integer"],"minimum":0},"coinbase":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"feeRecipient":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"gasFees":{"type":["object"],"properties":{"feePerDaGas":{"type":["string"],"pattern":"^\\d+$"},"feePerL2Gas":{"type":["string"],"pattern":"^\\d+$"}},"required":["feePerDaGas","feePerL2Gas"]}},"required":["chainId","version","blockNumber","slotNumber","timestamp","coinbase","feeRecipient","gasFees"]},"totalFees":{"type":["string"]},"totalManaUsed":{"type":["string"]}},"required":["lastArchive","spongeBlobHash","state","globalVariables","totalFees","totalManaUsed"]},"body":{"type":["object"],"properties":{"txEffects":{"type":["array"],"items":{"type":["object"],"properties":{"txHash":{}},"required":["txHash"]}}},"required":["txEffects"]}},"required":["hash","height","archive","header","body"]}}}}}}}},"/l2/reorgs":{"get":{"tags":["L2","blocks"],"summary":"Get information about chain reorganizations","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"orphanedBlockHash":{},"height":{"type":["string"]},"timestamp":{"type":["string"],"format":"date-time"},"nbrOfOrphanedBlocks":{"type":["integer"],"minimum":0}},"required":["orphanedBlockHash","height","timestamp","nbrOfOrphanedBlocks"]}}}}}}}},"/l2/fee-recipients":{"get":{"tags":["L2","fee-recipients"],"summary":"Get fee recipients","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"l2Address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"feesReceived":{"type":["string"]},"nbrOfBlocks":{"type":["number"]},"calculatedForNumberOfBlocks":{"type":["number"]},"partOfTotalFeesReceived":{"type":["number","null"]}},"required":["l2Address","feesReceived","nbrOfBlocks","calculatedForNumberOfBlocks"]}}}}}}}},"/l2/tx-effects":{"get":{"tags":["L2","tx-effects"],"summary":"Get all transaction effects","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"revertCode":{"type":["object"],"properties":{"code":{"type":["number"]}},"required":["code"]},"txHash":{},"txBirthTimestamp":{"type":["number"]},"transactionFee":{"type":["string"],"pattern":"^\\d+$"},"feePayer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"feePaymentMethod":{"type":["string"]},"initiator":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"noteHashes":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"nullifiers":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"l2ToL1Msgs":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"publicDataWrites":{"type":["array"],"items":{"type":["object"],"properties":{"leafSlot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"value":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["leafSlot","value"]}},"privateLogs":{"type":["array"],"items":{"type":["object"],"properties":{"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"emittedLength":{"type":["number"]}},"required":["fields","emittedLength"]}},"publicLogs":{"type":["array"],"items":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}}},"required":["contractAddress","fields"]}},"contractClassLogs":{"type":["array"],"items":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"emittedLength":{"type":["number"]}},"required":["contractAddress","fields","emittedLength"]}},"publicCallRequests":{"type":["array"],"items":{"type":["object"],"properties":{"msgSender":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"isStaticCall":{"type":["boolean"]},"calldataHash":{},"callType":{"type":["string"],"enum":["non_revertible","revertible","teardown"]},"functionSelector":{"type":["string","null"]},"contractName":{"type":["string","null"]},"functionName":{"type":["string","null"]},"timestamp":{"type":["number","null"]}},"required":["msgSender","contractAddress","isStaticCall","calldataHash","callType"]}},"blockHeight":{"type":["string"]},"blockHash":{},"isOrphaned":{"type":["boolean"]},"timestamp":{}},"required":["revertCode","txHash","txBirthTimestamp","transactionFee","noteHashes","nullifiers","l2ToL1Msgs","publicDataWrites","privateLogs","publicLogs","contractClassLogs","blockHeight","blockHash","isOrphaned","timestamp"]}}}}}}}},"/l2/blocks/{blockHeight}/txEffects":{"get":{"tags":["L2","tx-effects"],"summary":"Get transaction effects by block height","parameters":[{"name":"blockHeight","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"revertCode":{"type":["object"],"properties":{"code":{"type":["number"]}},"required":["code"]},"txHash":{},"txBirthTimestamp":{"type":["number"]},"transactionFee":{"type":["string"],"pattern":"^\\d+$"},"feePayer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"feePaymentMethod":{"type":["string"]},"initiator":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"noteHashes":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"nullifiers":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"l2ToL1Msgs":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"publicDataWrites":{"type":["array"],"items":{"type":["object"],"properties":{"leafSlot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"value":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["leafSlot","value"]}},"privateLogs":{"type":["array"],"items":{"type":["object"],"properties":{"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"emittedLength":{"type":["number"]}},"required":["fields","emittedLength"]}},"publicLogs":{"type":["array"],"items":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}}},"required":["contractAddress","fields"]}},"contractClassLogs":{"type":["array"],"items":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"emittedLength":{"type":["number"]}},"required":["contractAddress","fields","emittedLength"]}},"publicCallRequests":{"type":["array"],"items":{"type":["object"],"properties":{"msgSender":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"isStaticCall":{"type":["boolean"]},"calldataHash":{},"callType":{"type":["string"],"enum":["non_revertible","revertible","teardown"]},"functionSelector":{"type":["string","null"]},"contractName":{"type":["string","null"]},"functionName":{"type":["string","null"]},"timestamp":{"type":["number","null"]}},"required":["msgSender","contractAddress","isStaticCall","calldataHash","callType"]}},"blockHeight":{"type":["string"]},"blockHash":{},"isOrphaned":{"type":["boolean"]},"timestamp":{}},"required":["revertCode","txHash","txBirthTimestamp","transactionFee","noteHashes","nullifiers","l2ToL1Msgs","publicDataWrites","privateLogs","publicLogs","contractClassLogs","blockHeight","blockHash","isOrphaned","timestamp"]}}}}}}}},"/l2/blocks/{blockHeight}/txEffects/{txEffectIndex}":{"get":{"tags":["L2","tx-effects"],"summary":"Get a specific transaction effect by block height and index","parameters":[{"name":"blockHeight","in":"path","required":true,"schema":{"type":"integer"}},{"name":"txEffectIndex","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"revertCode":{"type":["object"],"properties":{"code":{"type":["number"]}},"required":["code"]},"txHash":{},"txBirthTimestamp":{"type":["number"]},"transactionFee":{"type":["string"],"pattern":"^\\d+$"},"feePayer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"feePaymentMethod":{"type":["string"]},"initiator":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"noteHashes":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"nullifiers":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"l2ToL1Msgs":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"publicDataWrites":{"type":["array"],"items":{"type":["object"],"properties":{"leafSlot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"value":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["leafSlot","value"]}},"privateLogs":{"type":["array"],"items":{"type":["object"],"properties":{"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"emittedLength":{"type":["number"]}},"required":["fields","emittedLength"]}},"publicLogs":{"type":["array"],"items":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}}},"required":["contractAddress","fields"]}},"contractClassLogs":{"type":["array"],"items":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"emittedLength":{"type":["number"]}},"required":["contractAddress","fields","emittedLength"]}},"publicCallRequests":{"type":["array"],"items":{"type":["object"],"properties":{"msgSender":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"isStaticCall":{"type":["boolean"]},"calldataHash":{},"callType":{"type":["string"],"enum":["non_revertible","revertible","teardown"]},"functionSelector":{"type":["string","null"]},"contractName":{"type":["string","null"]},"functionName":{"type":["string","null"]},"timestamp":{"type":["number","null"]}},"required":["msgSender","contractAddress","isStaticCall","calldataHash","callType"]}},"blockHeight":{"type":["string"]},"blockHash":{},"isOrphaned":{"type":["boolean"]},"timestamp":{}},"required":["revertCode","txHash","txBirthTimestamp","transactionFee","noteHashes","nullifiers","l2ToL1Msgs","publicDataWrites","privateLogs","publicLogs","contractClassLogs","blockHeight","blockHash","isOrphaned","timestamp"]}}}}}}},"/l2/txEffects/{hash}":{"get":{"tags":["L2","tx-effects"],"summary":"Get transaction effects by tx effect hash","parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"revertCode":{"type":["object"],"properties":{"code":{"type":["number"]}},"required":["code"]},"txHash":{},"txBirthTimestamp":{"type":["number"]},"transactionFee":{"type":["string"],"pattern":"^\\d+$"},"feePayer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"feePaymentMethod":{"type":["string"]},"initiator":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"noteHashes":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"nullifiers":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"l2ToL1Msgs":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"publicDataWrites":{"type":["array"],"items":{"type":["object"],"properties":{"leafSlot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"value":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["leafSlot","value"]}},"privateLogs":{"type":["array"],"items":{"type":["object"],"properties":{"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"emittedLength":{"type":["number"]}},"required":["fields","emittedLength"]}},"publicLogs":{"type":["array"],"items":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}}},"required":["contractAddress","fields"]}},"contractClassLogs":{"type":["array"],"items":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"fields":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"emittedLength":{"type":["number"]}},"required":["contractAddress","fields","emittedLength"]}},"publicCallRequests":{"type":["array"],"items":{"type":["object"],"properties":{"msgSender":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"isStaticCall":{"type":["boolean"]},"calldataHash":{},"callType":{"type":["string"],"enum":["non_revertible","revertible","teardown"]},"functionSelector":{"type":["string","null"]},"contractName":{"type":["string","null"]},"functionName":{"type":["string","null"]},"timestamp":{"type":["number","null"]}},"required":["msgSender","contractAddress","isStaticCall","calldataHash","callType"]}},"blockHeight":{"type":["string"]},"blockHash":{},"isOrphaned":{"type":["boolean"]},"timestamp":{}},"required":["revertCode","txHash","txBirthTimestamp","transactionFee","noteHashes","nullifiers","l2ToL1Msgs","publicDataWrites","privateLogs","publicLogs","contractClassLogs","blockHeight","blockHash","isOrphaned","timestamp"]}}}}}}},"/l2/txs":{"get":{"tags":["L2","pending-txs","tx-effects"],"summary":"Get pending transactions","parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"txHash":{},"feePayer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"birthTimestamp":{"default":1787691397248,"type":["number"]},"initiator":{"type":["string","null"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"expirationTimestamp":{"type":["number"]},"gasLimitDa":{"type":["number"]},"gasLimitL2":{"type":["number"]},"teardownGasLimitDa":{"type":["number"]},"teardownGasLimitL2":{"type":["number"]},"maxFeePerDaGas":{"type":["string"]},"maxFeePerL2Gas":{"type":["string"]},"maxPriorityFeePerDaGas":{"type":["string"]},"maxPriorityFeePerL2Gas":{"type":["string"]},"gasUsedDa":{"type":["number"]},"gasUsedL2":{"type":["number"]},"feePaymentMethod":{"type":["string"]},"noteHashCount":{"type":["number"]},"nullifierCount":{"type":["number"]},"l2ToL1MsgCount":{"type":["number"]},"privateLogCount":{"type":["number"]},"publicCallRequests":{"type":["array"],"items":{"type":["object"],"properties":{"msgSender":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"isStaticCall":{"type":["boolean"]},"calldataHash":{},"callType":{"type":["string"],"enum":["non_revertible","revertible","teardown"]},"functionSelector":{"type":["string","null"]},"contractName":{"type":["string","null"]},"functionName":{"type":["string","null"]},"timestamp":{"type":["number","null"]}},"required":["msgSender","contractAddress","isStaticCall","calldataHash","callType"]}},"l2ToL1Msgs":{"type":["array"],"items":{"type":["object"],"properties":{"txHash":{},"index":{"type":["number"]},"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"recipient":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"content":{"type":["string"]}},"required":["txHash","index","contractAddress","recipient","content"]}}},"required":["txHash","feePayer"]}}}}}}}},"/l2/txs/{hash}":{"get":{"tags":["L2","pending-txs","tx-effects"],"summary":"Get pending transactions by tx hash","parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"txHash":{},"feePayer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"birthTimestamp":{"default":1787691397248,"type":["number"]},"initiator":{"type":["string","null"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"expirationTimestamp":{"type":["number"]},"gasLimitDa":{"type":["number"]},"gasLimitL2":{"type":["number"]},"teardownGasLimitDa":{"type":["number"]},"teardownGasLimitL2":{"type":["number"]},"maxFeePerDaGas":{"type":["string"]},"maxFeePerL2Gas":{"type":["string"]},"maxPriorityFeePerDaGas":{"type":["string"]},"maxPriorityFeePerL2Gas":{"type":["string"]},"gasUsedDa":{"type":["number"]},"gasUsedL2":{"type":["number"]},"feePaymentMethod":{"type":["string"]},"noteHashCount":{"type":["number"]},"nullifierCount":{"type":["number"]},"l2ToL1MsgCount":{"type":["number"]},"privateLogCount":{"type":["number"]},"publicCallRequests":{"type":["array"],"items":{"type":["object"],"properties":{"msgSender":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"isStaticCall":{"type":["boolean"]},"calldataHash":{},"callType":{"type":["string"],"enum":["non_revertible","revertible","teardown"]},"functionSelector":{"type":["string","null"]},"contractName":{"type":["string","null"]},"functionName":{"type":["string","null"]},"timestamp":{"type":["number","null"]}},"required":["msgSender","contractAddress","isStaticCall","calldataHash","callType"]}},"l2ToL1Msgs":{"type":["array"],"items":{"type":["object"],"properties":{"txHash":{},"index":{"type":["number"]},"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"recipient":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"content":{"type":["string"]}},"required":["txHash","index","contractAddress","recipient","content"]}}},"required":["txHash","feePayer"]}}}}}}},"/l2/public-call-requests/{txHash}":{"get":{"tags":["L2","pending-txs","public-call-requests"],"summary":"Get public call requests by tx hash","parameters":[{"name":"txHash","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"Public call requests for the transaction","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"msgSender":{"type":"string"},"contractAddress":{"type":"string"},"isStaticCall":{"type":"boolean"},"calldataHash":{"type":"string"},"callType":{"type":"string","enum":["non_revertible","revertible","teardown"]},"functionSelector":{"type":"string","nullable":true},"contractName":{"type":"string","nullable":true},"functionName":{"type":"string","nullable":true},"timestamp":{"type":"number","nullable":true}}}}}}}}}},"/l2/public-call-requests":{"get":{"tags":["L2","public-call-requests"],"summary":"Get public call requests filtered by contractAddress or senderAddress query param","parameters":[{"name":"contractAddress","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}},{"name":"senderAddress","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"Public call requests matching the given filter","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"msgSender":{"type":"string"},"contractAddress":{"type":"string"},"isStaticCall":{"type":"boolean"},"calldataHash":{"type":"string"},"callType":{"type":"string","enum":["non_revertible","revertible","teardown"]},"functionSelector":{"type":"string","nullable":true},"contractName":{"type":"string","nullable":true},"functionName":{"type":"string","nullable":true},"timestamp":{"type":"number","nullable":true}}}}}}},"400":{"description":"Bad request — provide exactly one of contractAddress or senderAddress (not both, not neither)"}}}},"/l2/l2-to-l1-msgs/tx/{hash}":{"get":{"tags":["L2","pending-txs","l2-to-l1-msgs"],"summary":"Get L2-to-L1 messages by tx hash","parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"L2-to-L1 messages for the transaction","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"index":{"type":"number"},"contractAddress":{"type":"string"},"recipient":{"type":"string"},"content":{"type":"string"}}}}}}}}}},"/l2/l2-to-l1-msgs/contract/{address}":{"get":{"tags":["L2","l2-to-l1-msgs"],"summary":"Get L2-to-L1 messages by emitting contract address","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"L2-to-L1 messages emitted by the contract","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"index":{"type":"number"},"contractAddress":{"type":"string"},"recipient":{"type":"string"},"content":{"type":"string"}}}}}}}}}},"/l2/l2-to-l1-msgs/recipient/{address}":{"get":{"tags":["L2","l2-to-l1-msgs"],"summary":"Get L2-to-L1 messages by L1 recipient address","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"L2-to-L1 messages for the L1 recipient","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"index":{"type":"number"},"contractAddress":{"type":"string"},"recipient":{"type":"string"},"content":{"type":"string"}}}}}}}}}},"/l2/dropped-txs/{hash}":{"get":{"tags":["L2","dropped-txs","tx-effects"],"summary":"Get dropped transaction by hash","parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/l2/contract-classes/{classId}/versions/{version}":{"post":{"description":"Please check out our SDK for how to verify contract class artifact","tags":["L2","contract-classes"],"summary":"Register and verify contract class artifact","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"stringifiedArtifactJson":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"blockHash":{},"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"version":{"type":["number"]},"artifactHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"packedBytecode":{},"artifactJson":{"type":["string","null"]},"artifactContractName":{"type":["string","null"]},"selectorMap":{"type":["object","null"],"additionalProperties":{"type":["string"]}},"standardContractType":{"type":["string","null"]},"standardContractVersion":{"type":["string","null"]},"sourceCodeUrl":{"type":["string","null"]}},"required":["blockHash","contractClassId","version","artifactHash","privateFunctionsRoot","packedBytecode"]}}}}}}},"/l2/contract-classes/{classId}":{"get":{"tags":["L2","contract-classes"],"summary":"Get all versions of registered contract classes by contract class id","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"blockHash":{},"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"version":{"type":["number"]},"artifactHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"packedBytecode":{},"artifactJson":{"type":["string","null"]},"artifactContractName":{"type":["string","null"]},"selectorMap":{"type":["object","null"],"additionalProperties":{"type":["string"]}},"standardContractType":{"type":["string","null"]},"standardContractVersion":{"type":["string","null"]},"sourceCodeUrl":{"type":["string","null"]}},"required":["blockHash","contractClassId","version","artifactHash","privateFunctionsRoot","packedBytecode"]}}}}}}}},"/l2/contract-classes":{"get":{"tags":["L2","contract-classes"],"summary":"Get latest registered contract classes","parameters":[{"name":"verifiedSourceOnly","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"blockHash":{},"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"version":{"type":["number"]},"artifactHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"packedBytecode":{},"artifactJson":{"type":["string","null"]},"artifactContractName":{"type":["string","null"]},"selectorMap":{"type":["object","null"],"additionalProperties":{"type":["string"]}},"standardContractType":{"type":["string","null"]},"standardContractVersion":{"type":["string","null"]},"sourceCodeUrl":{"type":["string","null"]}},"required":["blockHash","contractClassId","version","artifactHash","privateFunctionsRoot","packedBytecode"]}}}}}}}},"/l2/contract-classes/{classId}/versions/{version}/verify-source":{"post":{"tags":["L2","contract-classes","source-verification"],"summary":"Submit a source code verification request","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"githubUrl":{"type":"string"},"gitRef":{"type":"string"},"subPath":{"type":"string"}},"required":["githubUrl"]}}}},"responses":{"200":{"description":"Source code already verified","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string","nullable":true},"status":{"type":"string"},"sourceCodeUrl":{"type":"string"}}}}}},"202":{"description":"Verification job created","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"404":{"description":"Contract class not found"},"429":{"description":"Too many concurrent verification requests"}}}},"/l2/contract-classes/{classId}/versions/{version}/verify-source/{jobId}":{"get":{"tags":["L2","contract-classes","source-verification"],"summary":"Get the status of a source verification job","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verification job status","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"contractClassId":{"type":"string"},"version":{"type":"number"},"githubUrl":{"type":"string"},"gitRef":{"type":"string","nullable":true},"subPath":{"type":"string","nullable":true},"aztecVersion":{"type":"string","nullable":true},"status":{"type":"string"},"commitHash":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"failureStage":{"type":"string","nullable":true},"compileOutput":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}}}}}},"404":{"description":"Job not found"}}}},"/l2/contract-classes/{classId}/versions/{version}/source":{"get":{"tags":["L2","contract-classes","source-verification"],"summary":"Get verified source code for a contract class","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verified source code","content":{"application/json":{"schema":{"type":"object","properties":{"contractClassId":{"type":"string"},"version":{"type":"number"},"sourceCodeUrl":{"type":"string"},"sourceCodeCommitHash":{"type":"string","nullable":true},"gitRef":{"type":"string","nullable":true},"aztecVersion":{"type":"string","nullable":true},"sourceCode":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}}}}}}}}},"404":{"description":"Contract class not found or source not verified"}}}},"/l2/artifacts/{artifactHash}":{"get":{"tags":["L2","artifacts"],"summary":"Get artifact JSON by artifact hash","parameters":[{"name":"artifactHash","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Artifact JSON","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Artifact not found"}}}},"/l2/contract-classes/{classId}/private-functions":{"get":{"tags":["L2","contract-classes"],"summary":"Get broadcasted private functions of registered contract class","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactMetadataHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"utilityFunctionsTreeRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionTreeSiblingPath":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"privateFunctionTreeLeafIndex":{"type":["number"]},"artifactFunctionTreeSiblingPath":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"artifactFunctionTreeLeafIndex":{"type":["number"]},"privateFunction":{"type":["object"],"properties":{"selector":{"type":["object"],"properties":{"value":{"type":["number"]}},"required":["value"]},"metadataHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"vkHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"bytecode":{}},"required":["selector","metadataHash","vkHash","bytecode"]}},"required":["contractClassId","artifactMetadataHash","utilityFunctionsTreeRoot","privateFunctionTreeSiblingPath","privateFunctionTreeLeafIndex","artifactFunctionTreeSiblingPath","artifactFunctionTreeLeafIndex","privateFunction"]}}}}}}}},"/l2/contract-classes/{classId}/private-functions/{functionSelector}":{"get":{"tags":["L2","contract-classes"],"summary":"Get broadcasted private function of registered contract class","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}},{"name":"functionSelector","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactMetadataHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"utilityFunctionsTreeRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionTreeSiblingPath":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"privateFunctionTreeLeafIndex":{"type":["number"]},"artifactFunctionTreeSiblingPath":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"artifactFunctionTreeLeafIndex":{"type":["number"]},"privateFunction":{"type":["object"],"properties":{"selector":{"type":["object"],"properties":{"value":{"type":["number"]}},"required":["value"]},"metadataHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"vkHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"bytecode":{}},"required":["selector","metadataHash","vkHash","bytecode"]}},"required":["contractClassId","artifactMetadataHash","utilityFunctionsTreeRoot","privateFunctionTreeSiblingPath","privateFunctionTreeLeafIndex","artifactFunctionTreeSiblingPath","artifactFunctionTreeLeafIndex","privateFunction"]}}}}}}},"/l2/contract-classes/{classId}/utility-functions":{"get":{"tags":["L2","contract-classes"],"summary":"Get broadcasted utility functions of registered contract class","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactMetadataHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsArtifactTreeRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactFunctionTreeSiblingPath":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"artifactFunctionTreeLeafIndex":{"type":["number"]},"utilityFunction":{"type":["object"],"properties":{"selector":{"type":["object"],"properties":{"value":{"type":["number"]}},"required":["value"]},"metadataHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"bytecode":{}},"required":["selector","metadataHash","bytecode"]}},"required":["contractClassId","artifactMetadataHash","privateFunctionsArtifactTreeRoot","artifactFunctionTreeSiblingPath","artifactFunctionTreeLeafIndex","utilityFunction"]}}}}}}}},"/l2/contract-classes/{classId}/utility-functions/{functionSelector}":{"get":{"tags":["L2","contract-classes"],"summary":"Get broadcasted utility function of registered contract class","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}},{"name":"functionSelector","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactMetadataHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsArtifactTreeRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactFunctionTreeSiblingPath":{"type":["array"],"items":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"artifactFunctionTreeLeafIndex":{"type":["number"]},"utilityFunction":{"type":["object"],"properties":{"selector":{"type":["object"],"properties":{"value":{"type":["number"]}},"required":["value"]},"metadataHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"bytecode":{}},"required":["selector","metadataHash","bytecode"]}},"required":["contractClassId","artifactMetadataHash","privateFunctionsArtifactTreeRoot","artifactFunctionTreeSiblingPath","artifactFunctionTreeLeafIndex","utilityFunction"]}}}}}}},"/l2/contract-instances/block/{blockHash}":{"get":{"tags":["L2","contract-instances"],"summary":"Get contract instances by block hash","parameters":[{"name":"blockHash","in":"path","required":true,"schema":{"type":"string"}},{"name":"includeArtifactJson","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"blockHash":{},"version":{"type":["number"]},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"currentContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"originalContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"initializationHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"aztecScanNotes":{"type":["object"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]},"publicKeys":{"type":["object"],"properties":{"masterNullifierPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterIncomingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterOutgoingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterTaggingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["masterNullifierPublicKey","masterIncomingViewingPublicKey","masterOutgoingViewingPublicKey","masterTaggingPublicKey"]},"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"packedBytecode":{},"artifactJson":{"type":["string","null"]},"artifactContractName":{"type":["string","null"]},"selectorMap":{"type":["object","null"],"additionalProperties":{"type":["string"]}},"standardContractType":{"type":["string","null"]},"standardContractVersion":{"type":["string","null"]},"sourceCodeUrl":{"type":["string","null"]},"blockHeight":{"type":["string"]},"isOrphaned":{"type":["boolean"]},"deployerMetadata":{"type":["object"],"properties":{"address":{},"contractIdentifier":{"type":["string"]},"details":{"type":["string"]},"creatorName":{"type":["string"]},"creatorContact":{"type":["string"]},"appUrl":{"type":["string"]},"repoUrl":{"type":["string"]},"uploadedAt":{"type":["string"],"format":"date-time"},"reviewedAt":{"type":["string"],"format":"date-time"},"contractType":{"type":["null"]},"aztecScanNotes":{"type":["object","null"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]}},"required":["address","contractIdentifier","details","creatorName","creatorContact","appUrl","repoUrl","uploadedAt"]},"verifiedDeploymentArguments":{"type":["object"],"properties":{"id":{"type":["string"],"format":"uuid"},"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"publicKeysString":{"type":["string"]},"constructorArgs":{"type":["array"],"items":{"type":["string"]}}},"required":["address","salt","deployer","publicKeysString","constructorArgs"]}},"required":["address","blockHash","version","salt","currentContractClassId","originalContractClassId","initializationHash","immutablesHash","deployer","publicKeys","contractClassId","artifactHash","privateFunctionsRoot","packedBytecode","isOrphaned"]}}}}}}}},"/l2/contract-classes/{classId}/contract-instances":{"get":{"tags":["L2","contract-instances"],"summary":"Get contract instances by contract class id","parameters":[{"name":"classId","in":"path","required":true,"schema":{"type":"string"}},{"name":"includeArtifactJson","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"blockHash":{},"version":{"type":["number"]},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"currentContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"originalContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"initializationHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"aztecScanNotes":{"type":["object"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]},"publicKeys":{"type":["object"],"properties":{"masterNullifierPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterIncomingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterOutgoingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterTaggingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["masterNullifierPublicKey","masterIncomingViewingPublicKey","masterOutgoingViewingPublicKey","masterTaggingPublicKey"]},"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"packedBytecode":{},"artifactJson":{"type":["string","null"]},"artifactContractName":{"type":["string","null"]},"selectorMap":{"type":["object","null"],"additionalProperties":{"type":["string"]}},"standardContractType":{"type":["string","null"]},"standardContractVersion":{"type":["string","null"]},"sourceCodeUrl":{"type":["string","null"]},"blockHeight":{"type":["string"]},"isOrphaned":{"type":["boolean"]},"deployerMetadata":{"type":["object"],"properties":{"address":{},"contractIdentifier":{"type":["string"]},"details":{"type":["string"]},"creatorName":{"type":["string"]},"creatorContact":{"type":["string"]},"appUrl":{"type":["string"]},"repoUrl":{"type":["string"]},"uploadedAt":{"type":["string"],"format":"date-time"},"reviewedAt":{"type":["string"],"format":"date-time"},"contractType":{"type":["null"]},"aztecScanNotes":{"type":["object","null"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]}},"required":["address","contractIdentifier","details","creatorName","creatorContact","appUrl","repoUrl","uploadedAt"]},"verifiedDeploymentArguments":{"type":["object"],"properties":{"id":{"type":["string"],"format":"uuid"},"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"publicKeysString":{"type":["string"]},"constructorArgs":{"type":["array"],"items":{"type":["string"]}}},"required":["address","salt","deployer","publicKeysString","constructorArgs"]}},"required":["address","blockHash","version","salt","currentContractClassId","originalContractClassId","initializationHash","immutablesHash","deployer","publicKeys","contractClassId","artifactHash","privateFunctionsRoot","packedBytecode","isOrphaned"]}}}}}}}},"/l2/contract-instances/{address}":{"get":{"tags":["L2","contract-instances"],"summary":"Get contract instance by address","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"includeArtifactJson","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"blockHash":{},"version":{"type":["number"]},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"currentContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"originalContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"initializationHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"aztecScanNotes":{"type":["object"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]},"publicKeys":{"type":["object"],"properties":{"masterNullifierPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterIncomingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterOutgoingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterTaggingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["masterNullifierPublicKey","masterIncomingViewingPublicKey","masterOutgoingViewingPublicKey","masterTaggingPublicKey"]},"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"packedBytecode":{},"artifactJson":{"type":["string","null"]},"artifactContractName":{"type":["string","null"]},"selectorMap":{"type":["object","null"],"additionalProperties":{"type":["string"]}},"standardContractType":{"type":["string","null"]},"standardContractVersion":{"type":["string","null"]},"sourceCodeUrl":{"type":["string","null"]},"blockHeight":{"type":["string"]},"isOrphaned":{"type":["boolean"]},"deployerMetadata":{"type":["object"],"properties":{"address":{},"contractIdentifier":{"type":["string"]},"details":{"type":["string"]},"creatorName":{"type":["string"]},"creatorContact":{"type":["string"]},"appUrl":{"type":["string"]},"repoUrl":{"type":["string"]},"uploadedAt":{"type":["string"],"format":"date-time"},"reviewedAt":{"type":["string"],"format":"date-time"},"contractType":{"type":["null"]},"aztecScanNotes":{"type":["object","null"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]}},"required":["address","contractIdentifier","details","creatorName","creatorContact","appUrl","repoUrl","uploadedAt"]},"verifiedDeploymentArguments":{"type":["object"],"properties":{"id":{"type":["string"],"format":"uuid"},"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"publicKeysString":{"type":["string"]},"constructorArgs":{"type":["array"],"items":{"type":["string"]}}},"required":["address","salt","deployer","publicKeysString","constructorArgs"]}},"required":["address","blockHash","version","salt","currentContractClassId","originalContractClassId","initializationHash","immutablesHash","deployer","publicKeys","contractClassId","artifactHash","privateFunctionsRoot","packedBytecode","isOrphaned"]}}}}}},"post":{"description":"Please check out our SDK for how to verify contract instance deployment","tags":["L2","contract-instances"],"summary":"Verify contract instance deployment","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"requestBody":{"content":{"application/json":{"schema":{"type":["object"],"properties":{"deployerMetadata":{"type":["object"],"properties":{"contractIdentifier":{"type":["string"]},"details":{"type":["string"]},"creatorName":{"type":["string"]},"creatorContact":{"type":["string"]},"appUrl":{"type":["string"]},"repoUrl":{"type":["string"]},"contractType":{"type":["null"]}},"required":["contractIdentifier","details","creatorName","creatorContact","appUrl","repoUrl"]},"verifiedDeploymentArguments":{"type":["object"],"properties":{"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"publicKeysString":{"type":["string"]},"constructorArgs":{"type":["array"],"items":{"type":["string"]}},"stringifiedArtifactJson":{"type":["string"]}},"required":["salt","deployer","publicKeysString","constructorArgs"]}},"required":["verifiedDeploymentArguments"]}}}},"responses":{"200":{"description":"Contract instance verification successful"},"400":{"description":"Bad request or verification failed"},"404":{"description":"Contract instance not found"},"500":{"description":"Internal server error"}}}},"/l2/contract-instances/{address}/balance":{"get":{"tags":["L2","contract-instances"],"summary":"Get contract instance balance by address","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}},{"name":"isPublic","in":"query","schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"balance":{"type":["string"]},"timestamp":{"default":1787691397251,"type":["number"]},"sourceTxHash":{},"feeRecipient":{"type":["string","null"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"blockNumber":{"type":["integer"],"format":"int64"}},"required":["contractAddress","balance"]}}}}}}},"/l2/contract-instances/{address}/balance/history":{"get":{"tags":["L2","contract-instances"],"summary":"Get contract instance balance history by address (limited to 1000 most recent entries)","description":"Returns the balance history for a contract instance, ordered chronologically by timestamp. Results are limited to the 1000 most recent entries for performance optimization.","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"balance":{"type":["string"]},"timestamp":{"default":1787691397251,"type":["number"]},"sourceTxHash":{},"feeRecipient":{"type":["string","null"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"blockNumber":{"type":["integer"],"format":"int64"}},"required":["contractAddress","balance"]}}}}}}}},"/l2/contract-instances/{address}/fpc-relationships":{"get":{"tags":["L2","contract-instances"],"summary":"Get Fee Paying Contract (FPC) relationships for an address","description":"Returns which FPCs pay fees for this address, and (if the address is itself an FPC) which addresses it sponsors.","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"FPC relationships for the address","content":{"application/json":{"schema":{"type":"object","properties":{"feePayers":{"type":"array","items":{"type":"string"},"description":"FPC addresses that pay fees for this address"},"sponsoredAddresses":{"type":"array","items":{"type":"string"},"description":"Addresses for which this FPC pays fees (only populated when the address is an FPC)"}}}}}}}}},"/l2/contract-instances/{address}/fpc-transactions":{"get":{"tags":["L2","contract-instances"],"summary":"Get FPC-related transactions for an address","description":"Returns transactions where this address paid fees for others (asFeePayer) and where others paid fees for this address (asSponsored).","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"}}],"responses":{"200":{"description":"FPC transactions for the address","content":{"application/json":{"schema":{"type":"object","properties":{"asFeePayer":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"feePayer":{"type":"string"},"sponsoredAddress":{"type":"string"},"transactionFee":{"type":"string"},"blockHeight":{"type":"integer"},"timestamp":{"type":"integer"}}}},"asSponsored":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"feePayer":{"type":"string"},"sponsoredAddress":{"type":"string"},"transactionFee":{"type":"string"},"blockHeight":{"type":"integer"},"timestamp":{"type":"integer"}}}}}}}}}}}},"/l2/contract-instances/with-balance":{"get":{"tags":["L2","contract-instances"],"summary":"Get all contract instances with balance","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"contractAddress":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"balance":{"type":["string"]},"timestamp":{"default":1787691397251,"type":["number"]},"sourceTxHash":{},"feeRecipient":{"type":["string","null"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"blockNumber":{"type":["integer"],"format":"int64"}},"required":["contractAddress","balance"]}}}}}}},"/l2/contract-instances":{"get":{"tags":["L2","contract-instances"],"summary":"Get contract instances between from and to block heights","parameters":[{"name":"fromHeight","in":"query","schema":{"type":"integer"}},{"name":"toHeight","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"blockHash":{},"version":{"type":["number"]},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"currentContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"originalContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"initializationHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"aztecScanNotes":{"type":["object"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]},"publicKeys":{"type":["object"],"properties":{"masterNullifierPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterIncomingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterOutgoingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterTaggingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["masterNullifierPublicKey","masterIncomingViewingPublicKey","masterOutgoingViewingPublicKey","masterTaggingPublicKey"]},"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"packedBytecode":{},"artifactJson":{"type":["string","null"]},"artifactContractName":{"type":["string","null"]},"selectorMap":{"type":["object","null"],"additionalProperties":{"type":["string"]}},"standardContractType":{"type":["string","null"]},"standardContractVersion":{"type":["string","null"]},"sourceCodeUrl":{"type":["string","null"]},"blockHeight":{"type":["string"]},"isOrphaned":{"type":["boolean"]},"deployerMetadata":{"type":["object"],"properties":{"address":{},"contractIdentifier":{"type":["string"]},"details":{"type":["string"]},"creatorName":{"type":["string"]},"creatorContact":{"type":["string"]},"appUrl":{"type":["string"]},"repoUrl":{"type":["string"]},"uploadedAt":{"type":["string"],"format":"date-time"},"reviewedAt":{"type":["string"],"format":"date-time"},"contractType":{"type":["null"]},"aztecScanNotes":{"type":["object","null"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]}},"required":["address","contractIdentifier","details","creatorName","creatorContact","appUrl","repoUrl","uploadedAt"]},"verifiedDeploymentArguments":{"type":["object"],"properties":{"id":{"type":["string"],"format":"uuid"},"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"publicKeysString":{"type":["string"]},"constructorArgs":{"type":["array"],"items":{"type":["string"]}}},"required":["address","salt","deployer","publicKeysString","constructorArgs"]}},"required":["address","blockHash","version","salt","currentContractClassId","originalContractClassId","initializationHash","immutablesHash","deployer","publicKeys","contractClassId","artifactHash","privateFunctionsRoot","packedBytecode","isOrphaned"]}}}}}}}},"/l2/contract-instances/with-aztec-scan-notes":{"get":{"tags":["L2","contract-instances"],"summary":"Get all contract instances with aztec scan notes","parameters":[{"name":"includeArtifactJson","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"blockHash":{},"version":{"type":["number"]},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"currentContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"originalContractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"initializationHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"aztecScanNotes":{"type":["object"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]},"publicKeys":{"type":["object"],"properties":{"masterNullifierPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterIncomingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterOutgoingViewingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"},"masterTaggingPublicKey":{"type":["string"],"minLength":130,"maxLength":130,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["masterNullifierPublicKey","masterIncomingViewingPublicKey","masterOutgoingViewingPublicKey","masterTaggingPublicKey"]},"contractClassId":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"artifactHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"privateFunctionsRoot":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"packedBytecode":{},"artifactJson":{"type":["string","null"]},"artifactContractName":{"type":["string","null"]},"selectorMap":{"type":["object","null"],"additionalProperties":{"type":["string"]}},"standardContractType":{"type":["string","null"]},"standardContractVersion":{"type":["string","null"]},"sourceCodeUrl":{"type":["string","null"]},"blockHeight":{"type":["string"]},"isOrphaned":{"type":["boolean"]},"deployerMetadata":{"type":["object"],"properties":{"address":{},"contractIdentifier":{"type":["string"]},"details":{"type":["string"]},"creatorName":{"type":["string"]},"creatorContact":{"type":["string"]},"appUrl":{"type":["string"]},"repoUrl":{"type":["string"]},"uploadedAt":{"type":["string"],"format":"date-time"},"reviewedAt":{"type":["string"],"format":"date-time"},"contractType":{"type":["null"]},"aztecScanNotes":{"type":["object","null"],"properties":{"name":{"type":["string"]},"origin":{"type":["string"]},"comment":{"type":["string"]},"category":{"type":["string","null"],"enum":["defi","bridge","privacy","infra","nft","gaming","social","dev"]},"relatedL1ContractAddresses":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"address":{"type":["string"]},"note":{"type":["string"]}},"required":["address","note"]}},"uploadedAt":{"type":["string"],"format":"date-time"},"updatedAt":{"type":["string"],"format":"date-time"}},"required":["name","origin","comment"]}},"required":["address","contractIdentifier","details","creatorName","creatorContact","appUrl","repoUrl","uploadedAt"]},"verifiedDeploymentArguments":{"type":["object"],"properties":{"id":{"type":["string"],"format":"uuid"},"address":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"salt":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"deployer":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"immutablesHash":{"type":["string"],"minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"},"publicKeysString":{"type":["string"]},"constructorArgs":{"type":["array"],"items":{"type":["string"]}}},"required":["address","salt","deployer","publicKeysString","constructorArgs"]}},"required":["address","blockHash","version","salt","currentContractClassId","originalContractClassId","initializationHash","immutablesHash","deployer","publicKeys","contractClassId","artifactHash","privateFunctionsRoot","packedBytecode","isOrphaned"]}}}}}}}},"/l2/search":{"get":{"tags":["L2","search"],"summary":"Search for blocks by hash, height, or slot; txEffects; contract classes; contract instances; and validators on Aztec","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{}}}}}}},"/l1/l2-validators":{"get":{"tags":["L1","l2-validators"],"summary":"Get L1 and L2 validators","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"rollupAddress":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"attester":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"stake":{"type":["string"]},"withdrawer":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"proposer":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"status":{"type":["string"],"enum":["NONE","VALIDATING","LIVING","EXITING",0,1,2,3]},"firstSeenAt":{"default":1787691397254,"type":["number"]},"latestSeenChangeAt":{"default":1787691397254,"type":["number"]}},"required":["rollupAddress","attester","stake","withdrawer","proposer","status"]}}}}}}}},"/l1/l2-validators/totals":{"get":{"tags":["L1","l2-validators"],"summary":"Get validator totals by status","responses":{"200":{"description":"Validator totals","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"validating":{"type":"integer"},"nonValidating":{"type":"integer"},"statusCounts":{"type":"object","additionalProperties":{"type":"integer"}},"totalStake":{"type":"string","description":"uint256"},"validatingStake":{"type":"string","description":"uint256"},"maxStake":{"type":"string","description":"uint256"},"stakeByStatus":{"type":"object","additionalProperties":{"type":"string","description":"uint256"}}},"required":["total","validating","nonValidating","statusCounts"]}}}}}}},"/l1/l2-validators/:attesterAddress":{"get":{"tags":["L1","l2-validators"],"summary":"Get L1L2Validator","parameters":[{"name":"attesterAddress","in":"path","required":true,"schema":{"type":"string","format":"hex"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"rollupAddress":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"attester":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"stake":{"type":["string"]},"withdrawer":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"proposer":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"},"status":{"type":["string"],"enum":["NONE","VALIDATING","LIVING","EXITING",0,1,2,3]},"firstSeenAt":{"default":1787691397254,"type":["number"]},"latestSeenChangeAt":{"default":1787691397254,"type":["number"]}},"required":["rollupAddress","attester","stake","withdrawer","proposer","status"]}}}}}}},"/l1/l2-validators/:attesterAddress/history":{"get":{"tags":["L1","l2-validators"],"summary":"Get L1L2Validator history","parameters":[{"name":"attesterAddress","in":"path","required":true,"schema":{"type":"string","format":"hex"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{}}}}}}}},"/l1/contract-events":{"get":{"tags":["L1","contract-events"],"summary":"Get L1 contract events","parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"id":{"type":["string"],"format":"uuid"},"eventName":{"type":["string"]},"eventArgs":{"type":["object"],"additionalProperties":{}},"l1BlockNumber":{"type":["string"]},"l1BlockHash":{"type":["string"]},"l1BlockTimestamp":{"type":["string"]},"l1ContractAddress":{"type":["string"]},"isFinalized":{"default":false,"type":["boolean"]},"l1TransactionHash":{"type":["string","null"]},"l1LogIndex":{"type":["integer","null"],"minimum":0}},"required":["eventName","l1BlockNumber","l1BlockHash","l1BlockTimestamp","l1ContractAddress"]}}}}}}},"/l1/contract-events/hourly-counts":{"get":{"tags":["L1","contract-events"],"summary":"Per-hour L1 contract event counts over a rolling window","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":168,"default":24},"description":"Window in hours (1–168). Defaults to 24."}],"responses":{"200":{"description":"Sparse list of buckets — empty hours are omitted, callers fill in zeros.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["hourStartMs","count"],"properties":{"hourStartMs":{"type":"integer"},"count":{"type":"integer"}}}}}}}}}},"/l1/fee-juice-portal-deposits/{address}":{"get":{"tags":["L1","fee-juice"],"summary":"Get L1→L2 fee juice deposits for an L2 address (FeeJuicePortal.DepositToAztecPublic)","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"description":"L2 recipient address (bytes32 / Fr hex)"}],"responses":{"200":{"description":"Fee juice deposits targeting this L2 address","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"l1BlockNumber":{"type":"string"},"l1BlockHash":{"type":"string"},"l1BlockTimestamp":{"type":"number"},"l1ContractAddress":{"type":"string"},"l1TransactionHash":{"type":"string"},"l1LogIndex":{"type":"number"},"isFinalized":{"type":"boolean"},"l1Sender":{"type":"string","description":"L1 address of the depositor (msg.sender on portal tx)"},"to":{"type":"string","description":"L2 recipient address (bytes32/Fr hex)"},"amount":{"type":"string","description":"Fee juice amount in wei (bigint as string)"},"secretHash":{"type":"string"},"key":{"type":"string","description":"Inbox message key (bytes32)"},"index":{"type":"string","description":"Inbox leaf index (bigint as string)"}}}}}}}}}},"/l1/governance/proposals":{"get":{"tags":["L1","governance"],"summary":"List governance proposals","parameters":[{"name":"state","in":"query","schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"integer"}},{"name":"to","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"List of governance proposals"}}}},"/l1/governance/proposals/:proposalId":{"get":{"tags":["L1","governance"],"summary":"Get a single governance proposal","parameters":[{"name":"proposalId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Proposal detail"},"404":{"description":"Proposal not found"}}}},"/l1/governance/proposals/:proposalId/votes":{"get":{"tags":["L1","governance"],"summary":"List votes for a proposal","parameters":[{"name":"proposalId","in":"path","required":true,"schema":{"type":"string"}},{"name":"support","in":"query","schema":{"type":"boolean"}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100}}],"responses":{"200":{"description":"List of votes"}}}},"/l1/governance/proposals/:proposalId/signals":{"get":{"tags":["L1","governance"],"summary":"List signals related to a proposal (by payload address)","parameters":[{"name":"proposalId","in":"path","required":true,"schema":{"type":"string"}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100}}],"responses":{"200":{"description":"List of signals"},"404":{"description":"Proposal not found"}}}},"/l1/governance/signals":{"get":{"tags":["L1","governance"],"summary":"List all governance signals","parameters":[{"name":"payloadAddress","in":"query","schema":{"type":"string"}},{"name":"round","in":"query","schema":{"type":"integer"}},{"name":"signaler","in":"query","schema":{"type":"string"}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100}}],"responses":{"200":{"description":"List of signals"}}}},"/l1/governance/signals/round/:round":{"get":{"tags":["L1","governance"],"summary":"List all signals in a specific round","parameters":[{"name":"round","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"List of signals for the round"}}}},"/l1/governance/signals/payload/:payloadAddress":{"get":{"tags":["L1","governance"],"summary":"List all signals for a specific payload","parameters":[{"name":"payloadAddress","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of signals for the payload"}}}},"/l1/governance/configurations":{"get":{"tags":["L1","governance"],"summary":"List historical governance configurations","parameters":[{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"List of configurations"}}}},"/l1/governance/proposer-history":{"get":{"tags":["L1","governance"],"summary":"List governance proposer change history","parameters":[{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"List of proposer history entries"}}}},"/l2/info":{"get":{"tags":["l2-chain"],"summary":"Get L2 chain info","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"l2NetworkId":{"type":["string"],"enum":["MAINNET","SANDBOX","DEVNET","TESTNET"]},"l1ChainId":{"type":["number"]},"rollupVersion":{"type":["string"]},"l1ContractAddresses":{"type":["object"],"properties":{"rollupAddress":{"type":["string"]},"registryAddress":{"type":["string"]},"inboxAddress":{"type":["string"]},"outboxAddress":{"type":["string"]},"feeJuiceAddress":{"type":["string"]},"feeJuicePortalAddress":{"type":["string"]},"coinIssuerAddress":{"type":["string"]},"rewardDistributorAddress":{"type":["string"]},"governanceProposerAddress":{"type":["string"]},"governanceAddress":{"type":["string"]},"stakingAssetAddress":{"type":["string"]}},"required":["rollupAddress","registryAddress","inboxAddress","outboxAddress","feeJuiceAddress","feeJuicePortalAddress","coinIssuerAddress","rewardDistributorAddress","governanceProposerAddress","governanceAddress","stakingAssetAddress"]},"protocolContractAddresses":{"type":["object"],"properties":{"classRegistry":{"type":["string"]},"feeJuice":{"type":["string"]},"instanceRegistry":{"type":["string"]},"multiCallEntrypoint":{"type":["string"]}},"required":["classRegistry","feeJuice","instanceRegistry","multiCallEntrypoint"]},"stakingAssetSymbol":{"type":["string"]},"stakingAssetDecimals":{"type":["integer"],"minimum":0},"feeJuiceSymbol":{"type":["string"]},"feeJuiceDecimals":{"type":["integer"],"minimum":0},"createdAt":{"type":["string"],"format":"date-time"},"latestUpdateAt":{"type":["string"],"format":"date-time"}},"required":["l2NetworkId","l1ChainId","rollupVersion","l1ContractAddresses","protocolContractAddresses"]}}}}}}},"/l2/tips":{"get":{"tags":["l2-chain"],"summary":"Get latest Aztec native L2 tips and health state","description":"Returns the latest L2 tip snapshot observed from AztecNode.getL2Tips(). `nativeStatus` is the product-facing block-display status derived from these tips. On Aztec v4, upstream `finalized` may currently equal `proven`. `checkpointed` means the block is at or below the latest checkpointed tip; `unknown` means tips are missing, stale/degraded, orphaned, or the block is above the proposed tip.","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"tips":{"type":["object"],"properties":{"proposed":{"type":["object"],"properties":{"number":{"type":["integer"],"minimum":0},"hash":{}},"required":["number","hash"]},"proposedCheckpoint":{"type":["object"],"properties":{"block":{"type":["object"],"properties":{"number":{"type":["integer"],"minimum":0},"hash":{}},"required":["number","hash"]},"checkpoint":{"type":["object"],"properties":{"number":{"type":["integer"],"minimum":0},"hash":{}},"required":["number","hash"]}},"required":["block","checkpoint"]},"checkpointed":{"type":["object"],"properties":{"block":{"type":["object"],"properties":{"number":{"type":["integer"],"minimum":0},"hash":{}},"required":["number","hash"]},"checkpoint":{"type":["object"],"properties":{"number":{"type":["integer"],"minimum":0},"hash":{}},"required":["number","hash"]}},"required":["block","checkpoint"]},"proven":{"type":["object"],"properties":{"block":{"type":["object"],"properties":{"number":{"type":["integer"],"minimum":0},"hash":{}},"required":["number","hash"]},"checkpoint":{"type":["object"],"properties":{"number":{"type":["integer"],"minimum":0},"hash":{}},"required":["number","hash"]}},"required":["block","checkpoint"]},"finalized":{"type":["object"],"properties":{"block":{"type":["object"],"properties":{"number":{"type":["integer"],"minimum":0},"hash":{}},"required":["number","hash"]},"checkpoint":{"type":["object"],"properties":{"number":{"type":["integer"],"minimum":0},"hash":{}},"required":["number","hash"]}},"required":["block","checkpoint"]}},"required":["proposed","checkpointed","proven","finalized"]},"observedAt":{"type":["integer"],"minimum":0},"stale":{"type":["boolean"]},"stalenessMs":{"type":["integer"],"minimum":0},"staleAfterMs":{"type":["integer"],"exclusiveMinimum":0},"degraded":{"type":["boolean"]},"degradedReason":{"type":["string"]},"repeatedDegradedBoundaryMismatch":{"type":["object"],"properties":{"bucket":{"type":["string"],"enum":["finalized","proven","checkpointed","proposed"]},"height":{"type":["integer"],"minimum":0},"expectedHash":{},"observedDbHash":{},"firstSeenAt":{"type":["string"]},"lastSeenAt":{"type":["string"]},"occurrenceCount":{"type":["integer"],"exclusiveMinimum":0},"reason":{"type":["string"]}},"required":["bucket","height","expectedHash","occurrenceCount","reason"]},"source":{"type":["object"],"properties":{"rpcNodeName":{"type":["string"]},"aztecNodeVersion":{"type":["string"]}}}},"required":["tips","observedAt","stale","stalenessMs","staleAfterMs","degraded","source"]}}}}}}},"/l2/rollup-versions":{"get":{"tags":["l2-chain"],"summary":"Get observed L2 rollup versions ordered by first seen time","responses":{"200":{"description":"Observed rollup versions"}}}},"/l2/errors":{"get":{"tags":["l2-chain"],"summary":"Get L2 chain errors","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"rpcNodeName":{"type":["string"]},"rpcUrl":{"type":["string"]},"name":{"type":["string"]},"cause":{"type":["string"]},"message":{"type":["string"]},"stack":{"type":["string"]},"data":{},"count":{"type":["number"]},"createdAt":{"type":["string"],"format":"date-time"},"lastSeenAt":{"type":["string"],"format":"date-time"}},"required":["rpcNodeName","name","cause","message","stack","count","createdAt","lastSeenAt"]}}}}}}}},"/l2/rpc-nodes/:rpcNodeName":{"get":{"tags":["L2","rpc-nodes"],"summary":"Get L2 rpc node by name","parameters":[{"name":"rpcNodeName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["object"],"properties":{"rpcNodeName":{"type":["string"]},"l2NetworkId":{"type":["string"],"enum":["MAINNET","SANDBOX","DEVNET","TESTNET"]},"rollupVersion":{"type":["string"]},"nodeVersion":{"type":["string"]},"l1ChainId":{"type":["number"]},"createdAt":{"type":["string"],"format":"date-time"},"lastSeenAt":{"type":["string"],"format":"date-time"},"errors":{"type":["array"],"items":{"type":["object"],"properties":{"rpcNodeName":{"type":["string"]},"rpcUrl":{"type":["string"]},"name":{"type":["string"]},"cause":{"type":["string"]},"message":{"type":["string"]},"stack":{"type":["string"]},"data":{},"count":{"type":["number"]},"createdAt":{"type":["string"],"format":"date-time"},"lastSeenAt":{"type":["string"],"format":"date-time"}},"required":["rpcNodeName","name","cause","message","stack","count","createdAt","lastSeenAt"]}}},"required":["rpcNodeName","l2NetworkId","rollupVersion","nodeVersion","l1ChainId","createdAt","lastSeenAt","errors"]}}}}}}},"/l2/rpc-nodes":{"get":{"tags":["L2","rpc-nodes"],"summary":"Get all L2 rpc nodes","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"rpcNodeName":{"type":["string"]},"l2NetworkId":{"type":["string"],"enum":["MAINNET","SANDBOX","DEVNET","TESTNET"]},"rollupVersion":{"type":["string"]},"nodeVersion":{"type":["string"]},"l1ChainId":{"type":["number"]},"createdAt":{"type":["string"],"format":"date-time"},"lastSeenAt":{"type":["string"],"format":"date-time"}},"required":["rpcNodeName","l2NetworkId","rollupVersion","nodeVersion","l1ChainId","createdAt","lastSeenAt"]}}}}}}}},"/l2/search/public-logs":{"get":{"tags":["L2","search"],"summary":"Search for transaction effects by Fr value in public logs","parameters":[{"name":"frLogEntry","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"description":"The Fr value to search for in the public logs (must start with 0x)"},{"name":"index","in":"query","required":true,"schema":{"type":"integer","minimum":0},"description":"The index position in the log array to match the Fr value"}],"responses":{"200":{"description":"List of transaction hashes that contain the specified Fr value in public logs","content":{"application/json":{"schema":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"}}}}}}}},"/l2/ui/blocks-for-table":{"get":{"tags":["L2","ui","blocks"],"summary":"Get block table rows for the UI","parameters":[{"name":"from","in":"query","schema":{"type":"integer"}},{"name":"to","in":"query","schema":{"type":"integer"}},{"name":"status","in":"query","schema":{"type":"string","enum":["proposed","checkpointed","proven","finalized","unknown","orphaned"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"blockHash":{},"height":{"type":["string"]},"timestamp":{"type":["integer"],"minimum":0},"txEffectsLength":{"type":["number"]},"nativeStatus":{"type":["string"],"enum":["proposed","checkpointed","proven","finalized","unknown"],"description":"Product-facing Aztec-native block status derived from L2 tips."},"orphan":{"default":false,"type":["boolean"]},"coinbase":{"type":["string"],"minLength":42,"maxLength":42,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["blockHash","height","timestamp","txEffectsLength"]}}}}}}}},"/l2/ui/tx-effects-for-table":{"get":{"tags":["L2","ui","tx-effects"],"summary":"Get tx effect table rows for the UI","parameters":[{"name":"from","in":"query","schema":{"type":"integer"}},{"name":"to","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"blockNumber":{"type":["string"]},"txHash":{},"transactionFee":{"type":["string"],"pattern":"^\\d+$"},"timestamp":{"type":["integer"],"minimum":0}},"required":["blockNumber","txHash","transactionFee","timestamp"]}}}}}}}},"/l2/ui/tx-effects-for-table/{blockHeight}":{"get":{"tags":["L2","ui","tx-effects"],"summary":"Get tx effect table rows for a block height","parameters":[{"name":"blockHeight","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":["array"],"items":{"type":["object"],"properties":{"blockNumber":{"type":["string"]},"txHash":{},"transactionFee":{"type":["string"],"pattern":"^\\d+$"},"timestamp":{"type":["integer"],"minimum":0}},"required":["blockNumber","txHash","transactionFee","timestamp"]}}}}}}}}}}