@tabai/sdk 0.2.0

package/dist/_shared/abi.js

@@ -0,0 +1,197 @@
+/**
+ * Contract interface constants shared by the SDK, the gateway, the registry
+ * indexer, and the dashboard.
+ *
+ * Only what is fixed and independently checkable lives here: canonical event
+ * signatures and the topic hashes derived from them. Full ABI arrays come from
+ * the Foundry artefacts in `packages/contracts/out`, never from a hand
+ * transcription, so there is one source of truth for every selector.
+ */
+import { keccak256Ascii } from "./keccak256.js";
+/**
+ * Canonical event signatures, the exact strings the topic hash is taken over.
+ * No spaces, no parameter names, canonical types.
+ */
+export const EVENT_SIGNATURES = {
+    /** `TabBook.SettlementApplied`: a Settlement lowered an Open Tab. `topics[1]` is the settlement id. */
+    SettlementApplied: "SettlementApplied(bytes32,address,bytes32,address,uint256,uint256,uint128)",
+    /** `TabBook.DeliveryRecorded`: a Service metered usage into an Open Tab. `topics[1]` is the Agent. */
+    DeliveryRecorded: "DeliveryRecorded(address,bytes32,address,bytes32,uint32,uint256,uint64)",
+    /** `TabBook.HistoryExtended`: the Agent's history commitment advanced by one record. */
+    HistoryExtended: "HistoryExtended(address,address,bytes32,uint32,(bytes32,address,uint128,uint64,uint64,bool,bool))",
+    /** `TabBook.TabDelinquent`: a Settlement Window closed with the tab still open. */
+    TabDelinquent: "TabDelinquent(bytes32,address,bytes32,address,uint128,uint64)",
+    /** `TabBook.TabDelinquencyCleared`: the delinquent tab settled to zero. */
+    TabDelinquencyCleared: "TabDelinquencyCleared(bytes32,address,address)",
+    /** `TabSettlement.Settled`: the Asset moved from the Agent to the Service's Collection address. */
+    Settled: "Settled(bytes32,address,bytes32,address,uint128,uint128,uint128,address)",
+    /**
+     * `TabSettlement.SettledGasless`: the Settlement arrived on the Agent's Permit2 signature and
+     * `topics[2]` is the relayer that paid for it. Always follows a `Settled` with the same id.
+     */
+    SettledGasless: "SettledGasless(bytes32,address)",
+    /** `Bond.BondFunded`: stake entered the escrow. */
+    BondFunded: "BondFunded(bytes32,address,uint128,address)",
+    /** `Bond.BondWithdrawn`: stake left the escrow. */
+    BondWithdrawn: "BondWithdrawn(bytes32,address,uint128,address)",
+    /** ERC-20 `Transfer`, for reading balances and payouts off the Asset contract. */
+    Transfer: "Transfer(address,address,uint256)",
+};
+/**
+ * `topics[0]` for each pinned event: the Keccak-256 hash of its canonical
+ * signature. Derived rather than transcribed, so a signature edit cannot leave a
+ * stale hash behind.
+ */
+export const EVENT_TOPIC0 = Object.fromEntries(Object.entries(EVENT_SIGNATURES).map(([name, signature]) => [name, keccak256Ascii(signature)]));
+/** `topics[0]` for a pinned event. */
+export const eventTopic0 = (name) => EVENT_TOPIC0[name];
+// ---------------------------------------------------------------------------
+// Gasless Settlement through Permit2
+//
+// `TabSettlement.settleWithPermit2` verifies an EIP-712 signature the Agent
+// made under Permit2's domain, over Permit2's `PermitWitnessTransferFrom` with
+// a Tab-specific witness. Everything a signer needs is pinned here so the SDK
+// cannot drift from the contract: the witness type, the string the contract
+// hands Permit2, and the typed-data layout for `signTypedData`.
+// ---------------------------------------------------------------------------
+/**
+ * The witness struct, exactly as `TabSettlement.WITNESS_TYPE` declares it.
+ * `surface` is the `TabSettlement` address and `chainId` the chain it lives on.
+ */
+export const TAB_SETTLEMENT_WITNESS_TYPE = "TabSettlement(bytes32 serviceId,address asset,uint128 amount,address surface,uint256 chainId)";
+/** `keccak256(TAB_SETTLEMENT_WITNESS_TYPE)`, the same value as `TabSettlement.WITNESS_TYPEHASH`. */
+export const TAB_SETTLEMENT_WITNESS_TYPEHASH = keccak256Ascii(TAB_SETTLEMENT_WITNESS_TYPE);
+/**
+ * What the contract passes Permit2 as `witnessTypeString`, exactly as
+ * `TabSettlement.WITNESS_TYPE_STRING` declares it. Permit2 appends it to
+ * `PERMIT2_WITNESS_TRANSFER_FROM_STUB`.
+ */
+export const PERMIT2_WITNESS_TYPE_STRING = `TabSettlement witness)${TAB_SETTLEMENT_WITNESS_TYPE}TokenPermissions(address token,uint256 amount)`;
+/** Permit2's own `_PERMIT_TRANSFER_FROM_WITNESS_TYPEHASH_STUB`. */
+export const PERMIT2_WITNESS_TRANSFER_FROM_STUB = "PermitWitnessTransferFrom(TokenPermissions permitted,address spender,uint256 nonce,uint256 deadline,";
+/** The full primary type Permit2 hashes, and its typehash. */
+export const PERMIT2_WITNESS_TRANSFER_FROM_TYPE = `${PERMIT2_WITNESS_TRANSFER_FROM_STUB}${PERMIT2_WITNESS_TYPE_STRING}`;
+export const PERMIT2_WITNESS_TRANSFER_FROM_TYPEHASH = keccak256Ascii(PERMIT2_WITNESS_TRANSFER_FROM_TYPE);
+/** Permit2's EIP-712 domain name. Its domain has no `version`. */
+export const PERMIT2_DOMAIN_NAME = "Permit2";
+/**
+ * The EIP-712 domain an Agent signs a gasless Settlement under: Permit2's, on
+ * the chain the Settlement happens on.
+ */
+export function permit2Domain(chainId, permit2) {
+    return {
+        name: PERMIT2_DOMAIN_NAME,
+        chainId: typeof chainId === "bigint" ? chainId : BigInt(chainId),
+        verifyingContract: permit2,
+    };
+}
+/**
+ * The typed-data types for `signTypedData`, primary type
+ * `PermitWitnessTransferFrom`. Field order matches Permit2's stub and the
+ * witness type above; the referenced structs are what the type string names.
+ */
+export const PERMIT2_WITNESS_TRANSFER_FROM_TYPES = {
+    PermitWitnessTransferFrom: [
+        { name: "permitted", type: "TokenPermissions" },
+        { name: "spender", type: "address" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" },
+        { name: "witness", type: "TabSettlement" },
+    ],
+    TokenPermissions: [
+        { name: "token", type: "address" },
+        { name: "amount", type: "uint256" },
+    ],
+    TabSettlement: [
+        { name: "serviceId", type: "bytes32" },
+        { name: "asset", type: "address" },
+        { name: "amount", type: "uint128" },
+        { name: "surface", type: "address" },
+        { name: "chainId", type: "uint256" },
+    ],
+};
+export const PERMIT2_WITNESS_TRANSFER_FROM_PRIMARY_TYPE = "PermitWitnessTransferFrom";
+/**
+ * The gasless entry point on `TabSettlement`, as a human-readable ABI fragment.
+ * `spender` in the signed message is the `TabSettlement` address and `witness`
+ * is `TabSettlement.witnessHash(serviceId, asset, amount)`.
+ */
+export const TAB_SETTLEMENT_PERMIT2_ABI = [
+    "function settleWithPermit2(address agent, bytes32 serviceId, address asset, uint128 amount, uint256 nonce, uint256 deadline, bytes signature) returns (bytes32 settlementId, uint128 applied, uint128 toPrepaid)",
+    "function witnessHash(bytes32 serviceId, address asset, uint128 amount) view returns (bytes32)",
+    "function WITNESS_TYPE_STRING() view returns (string)",
+    "function WITNESS_TYPEHASH() view returns (bytes32)",
+    "function PERMIT2() view returns (address)",
+    "event SettledGasless(bytes32 indexed settlementId, address indexed relayer)",
+];
+/** The slice of Permit2 a signer or relayer touches, as human-readable ABI. */
+export const PERMIT2_ABI = [
+    "function DOMAIN_SEPARATOR() view returns (bytes32)",
+    "function nonceBitmap(address owner, uint256 wordPosition) view returns (uint256)",
+    "function invalidateUnorderedNonces(uint256 wordPos, uint256 mask)",
+    "event UnorderedNonceInvalidation(address indexed owner, uint256 word, uint256 mask)",
+];
+// ---------------------------------------------------------------------------
+// ERC-8004
+//
+// Human-readable fragments copied from `IdentityRegistryUpgradeable` and
+// `ReputationRegistryUpgradeable` in erc-8004/erc-8004-contracts, the
+// implementations behind the canonical proxies (`getVersion()` reports 2.0.0).
+// Only what Tab reads and writes; the ERC-721 and UUPS surface is omitted.
+// ---------------------------------------------------------------------------
+/**
+ * The Identity Registry: an ERC-721 whose token id is the agentId, whose
+ * `tokenURI` is the agent's registration file, and whose `agentWallet`
+ * metadata is the account acting for the agent. `register` mints to the
+ * caller and records it as the wallet; ids are sequential from zero.
+ */
+export const ERC8004_IDENTITY_REGISTRY_ABI = [
+    "function register() returns (uint256 agentId)",
+    "function register(string agentURI) returns (uint256 agentId)",
+    "function register(string agentURI, (string metadataKey, bytes metadataValue)[] metadata) returns (uint256 agentId)",
+    "function setAgentURI(uint256 agentId, string newURI)",
+    "function tokenURI(uint256 tokenId) view returns (string)",
+    "function ownerOf(uint256 tokenId) view returns (address)",
+    "function balanceOf(address owner) view returns (uint256)",
+    "function getAgentWallet(uint256 agentId) view returns (address)",
+    "function getMetadata(uint256 agentId, string metadataKey) view returns (bytes)",
+    "function setMetadata(uint256 agentId, string metadataKey, bytes metadataValue)",
+    "function isAuthorizedOrOwner(address spender, uint256 agentId) view returns (bool)",
+    "function getVersion() pure returns (string)",
+    "event Registered(uint256 indexed agentId, string agentURI, address indexed owner)",
+    "event URIUpdated(uint256 indexed agentId, string newURI, address indexed updatedBy)",
+    "event MetadataSet(uint256 indexed agentId, string indexed indexedMetadataKey, string metadataKey, bytes metadataValue)",
+    "event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)",
+];
+/**
+ * The Reputation Registry: feedback about an agent, keyed by agentId and the
+ * client that gave it, 1-indexed per client. An agent's owner or operator
+ * cannot give feedback about it.
+ */
+export const ERC8004_REPUTATION_REGISTRY_ABI = [
+    "function giveFeedback(uint256 agentId, int128 value, uint8 valueDecimals, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash)",
+    "function revokeFeedback(uint256 agentId, uint64 feedbackIndex)",
+    "function appendResponse(uint256 agentId, address clientAddress, uint64 feedbackIndex, string responseURI, bytes32 responseHash)",
+    "function getSummary(uint256 agentId, address[] clientAddresses, string tag1, string tag2) view returns (uint64 count, int128 summaryValue, uint8 summaryValueDecimals)",
+    "function readFeedback(uint256 agentId, address clientAddress, uint64 feedbackIndex) view returns (int128 value, uint8 valueDecimals, string tag1, string tag2, bool isRevoked)",
+    "function readAllFeedback(uint256 agentId, address[] clientAddresses, string tag1, string tag2, bool includeRevoked) view returns (address[] clients, uint64[] feedbackIndexes, int128[] values, uint8[] valueDecimals, string[] tag1s, string[] tag2s, bool[] revokedStatuses)",
+    "function getLastIndex(uint256 agentId, address clientAddress) view returns (uint64)",
+    "function getClients(uint256 agentId) view returns (address[])",
+    "function getIdentityRegistry() view returns (address)",
+    "function getVersion() pure returns (string)",
+    "event NewFeedback(uint256 indexed agentId, address indexed clientAddress, uint64 feedbackIndex, int128 value, uint8 valueDecimals, string indexed indexedTag1, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash)",
+    "event FeedbackRevoked(uint256 indexed agentId, address indexed clientAddress, uint64 indexed feedbackIndex)",
+    "event ResponseAppended(uint256 indexed agentId, address indexed clientAddress, uint64 feedbackIndex, address indexed responder, string responseURI, bytes32 responseHash)",
+];
+/** Canonical ERC-8004 event signatures, for topic filters. */
+export const ERC8004_EVENT_SIGNATURES = {
+    Registered: "Registered(uint256,string,address)",
+    URIUpdated: "URIUpdated(uint256,string,address)",
+    MetadataSet: "MetadataSet(uint256,string,string,bytes)",
+    NewFeedback: "NewFeedback(uint256,address,uint64,int128,uint8,string,string,string,string,string,bytes32)",
+    FeedbackRevoked: "FeedbackRevoked(uint256,address,uint64)",
+    ResponseAppended: "ResponseAppended(uint256,address,uint64,address,string,bytes32)",
+};
+/** `topics[0]` for each ERC-8004 event, derived from its canonical signature. */
+export const ERC8004_EVENT_TOPIC0 = Object.fromEntries(Object.entries(ERC8004_EVENT_SIGNATURES).map(([name, signature]) => [name, keccak256Ascii(signature)]));
+//# sourceMappingURL=abi.js.map

package/dist/_shared/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Contract interface constants shared by the SDK, the gateway, the registry\n * indexer, and the dashboard.\n *\n * Only what is fixed and independently checkable lives here: canonical event\n * signatures and the topic hashes derived from them. Full ABI arrays come from\n * the Foundry artefacts in `packages/contracts/out`, never from a hand\n * transcription, so there is one source of truth for every selector.\n */\nimport { keccak256Ascii } from \"./keccak256.js\";\nimport type { Bytes32 } from \"./hex.js\";\n\n/**\n * Canonical event signatures, the exact strings the topic hash is taken over.\n * No spaces, no parameter names, canonical types.\n */\nexport const EVENT_SIGNATURES = {\n  /** `TabBook.SettlementApplied`: a Settlement lowered an Open Tab. `topics[1]` is the settlement id. */\n  SettlementApplied: \"SettlementApplied(bytes32,address,bytes32,address,uint256,uint256,uint128)\",\n  /** `TabBook.DeliveryRecorded`: a Service metered usage into an Open Tab. `topics[1]` is the Agent. */\n  DeliveryRecorded: \"DeliveryRecorded(address,bytes32,address,bytes32,uint32,uint256,uint64)\",\n  /** `TabBook.HistoryExtended`: the Agent's history commitment advanced by one record. */\n  HistoryExtended:\n    \"HistoryExtended(address,address,bytes32,uint32,(bytes32,address,uint128,uint64,uint64,bool,bool))\",\n  /** `TabBook.TabDelinquent`: a Settlement Window closed with the tab still open. */\n  TabDelinquent: \"TabDelinquent(bytes32,address,bytes32,address,uint128,uint64)\",\n  /** `TabBook.TabDelinquencyCleared`: the delinquent tab settled to zero. */\n  TabDelinquencyCleared: \"TabDelinquencyCleared(bytes32,address,address)\",\n  /** `TabSettlement.Settled`: the Asset moved from the Agent to the Service's Collection address. */\n  Settled: \"Settled(bytes32,address,bytes32,address,uint128,uint128,uint128,address)\",\n  /**\n   * `TabSettlement.SettledGasless`: the Settlement arrived on the Agent's Permit2 signature and\n   * `topics[2]` is the relayer that paid for it. Always follows a `Settled` with the same id.\n   */\n  SettledGasless: \"SettledGasless(bytes32,address)\",\n  /** `Bond.BondFunded`: stake entered the escrow. */\n  BondFunded: \"BondFunded(bytes32,address,uint128,address)\",\n  /** `Bond.BondWithdrawn`: stake left the escrow. */\n  BondWithdrawn: \"BondWithdrawn(bytes32,address,uint128,address)\",\n  /** ERC-20 `Transfer`, for reading balances and payouts off the Asset contract. */\n  Transfer: \"Transfer(address,address,uint256)\",\n} as const;\n\n/** Name of an event whose signature this module pins. */\nexport type EventName = keyof typeof EVENT_SIGNATURES;\n\n/**\n * `topics[0]` for each pinned event: the Keccak-256 hash of its canonical\n * signature. Derived rather than transcribed, so a signature edit cannot leave a\n * stale hash behind.\n */\nexport const EVENT_TOPIC0: Readonly<Record<EventName, Bytes32>> = Object.fromEntries(\n  Object.entries(EVENT_SIGNATURES).map(([name, signature]) => [name, keccak256Ascii(signature)]),\n) as Record<EventName, Bytes32>;\n\n/** `topics[0]` for a pinned event. */\nexport const eventTopic0 = (name: EventName): Bytes32 => EVENT_TOPIC0[name];\n\n// ---------------------------------------------------------------------------\n// Gasless Settlement through Permit2\n//\n// `TabSettlement.settleWithPermit2` verifies an EIP-712 signature the Agent\n// made under Permit2's domain, over Permit2's `PermitWitnessTransferFrom` with\n// a Tab-specific witness. Everything a signer needs is pinned here so the SDK\n// cannot drift from the contract: the witness type, the string the contract\n// hands Permit2, and the typed-data layout for `signTypedData`.\n// ---------------------------------------------------------------------------\n\n/**\n * The witness struct, exactly as `TabSettlement.WITNESS_TYPE` declares it.\n * `surface` is the `TabSettlement` address and `chainId` the chain it lives on.\n */\nexport const TAB_SETTLEMENT_WITNESS_TYPE =\n  \"TabSettlement(bytes32 serviceId,address asset,uint128 amount,address surface,uint256 chainId)\" as const;\n\n/** `keccak256(TAB_SETTLEMENT_WITNESS_TYPE)`, the same value as `TabSettlement.WITNESS_TYPEHASH`. */\nexport const TAB_SETTLEMENT_WITNESS_TYPEHASH: Bytes32 = keccak256Ascii(TAB_SETTLEMENT_WITNESS_TYPE);\n\n/**\n * What the contract passes Permit2 as `witnessTypeString`, exactly as\n * `TabSettlement.WITNESS_TYPE_STRING` declares it. Permit2 appends it to\n * `PERMIT2_WITNESS_TRANSFER_FROM_STUB`.\n */\nexport const PERMIT2_WITNESS_TYPE_STRING =\n  `TabSettlement witness)${TAB_SETTLEMENT_WITNESS_TYPE}TokenPermissions(address token,uint256 amount)` as const;\n\n/** Permit2's own `_PERMIT_TRANSFER_FROM_WITNESS_TYPEHASH_STUB`. */\nexport const PERMIT2_WITNESS_TRANSFER_FROM_STUB =\n  \"PermitWitnessTransferFrom(TokenPermissions permitted,address spender,uint256 nonce,uint256 deadline,\" as const;\n\n/** The full primary type Permit2 hashes, and its typehash. */\nexport const PERMIT2_WITNESS_TRANSFER_FROM_TYPE =\n  `${PERMIT2_WITNESS_TRANSFER_FROM_STUB}${PERMIT2_WITNESS_TYPE_STRING}` as const;\nexport const PERMIT2_WITNESS_TRANSFER_FROM_TYPEHASH: Bytes32 = keccak256Ascii(\n  PERMIT2_WITNESS_TRANSFER_FROM_TYPE,\n);\n\n/** Permit2's EIP-712 domain name. Its domain has no `version`. */\nexport const PERMIT2_DOMAIN_NAME = \"Permit2\" as const;\n\n/**\n * The EIP-712 domain an Agent signs a gasless Settlement under: Permit2's, on\n * the chain the Settlement happens on.\n */\nexport function permit2Domain(chainId: number | bigint, permit2: `0x${string}`) {\n  return {\n    name: PERMIT2_DOMAIN_NAME,\n    chainId: typeof chainId === \"bigint\" ? chainId : BigInt(chainId),\n    verifyingContract: permit2,\n  } as const;\n}\n\n/**\n * The typed-data types for `signTypedData`, primary type\n * `PermitWitnessTransferFrom`. Field order matches Permit2's stub and the\n * witness type above; the referenced structs are what the type string names.\n */\nexport const PERMIT2_WITNESS_TRANSFER_FROM_TYPES = {\n  PermitWitnessTransferFrom: [\n    { name: \"permitted\", type: \"TokenPermissions\" },\n    { name: \"spender\", type: \"address\" },\n    { name: \"nonce\", type: \"uint256\" },\n    { name: \"deadline\", type: \"uint256\" },\n    { name: \"witness\", type: \"TabSettlement\" },\n  ],\n  TokenPermissions: [\n    { name: \"token\", type: \"address\" },\n    { name: \"amount\", type: \"uint256\" },\n  ],\n  TabSettlement: [\n    { name: \"serviceId\", type: \"bytes32\" },\n    { name: \"asset\", type: \"address\" },\n    { name: \"amount\", type: \"uint128\" },\n    { name: \"surface\", type: \"address\" },\n    { name: \"chainId\", type: \"uint256\" },\n  ],\n} as const;\n\nexport const PERMIT2_WITNESS_TRANSFER_FROM_PRIMARY_TYPE = \"PermitWitnessTransferFrom\" as const;\n\n/**\n * The gasless entry point on `TabSettlement`, as a human-readable ABI fragment.\n * `spender` in the signed message is the `TabSettlement` address and `witness`\n * is `TabSettlement.witnessHash(serviceId, asset, amount)`.\n */\nexport const TAB_SETTLEMENT_PERMIT2_ABI = [\n  \"function settleWithPermit2(address agent, bytes32 serviceId, address asset, uint128 amount, uint256 nonce, uint256 deadline, bytes signature) returns (bytes32 settlementId, uint128 applied, uint128 toPrepaid)\",\n  \"function witnessHash(bytes32 serviceId, address asset, uint128 amount) view returns (bytes32)\",\n  \"function WITNESS_TYPE_STRING() view returns (string)\",\n  \"function WITNESS_TYPEHASH() view returns (bytes32)\",\n  \"function PERMIT2() view returns (address)\",\n  \"event SettledGasless(bytes32 indexed settlementId, address indexed relayer)\",\n] as const;\n\n/** The slice of Permit2 a signer or relayer touches, as human-readable ABI. */\nexport const PERMIT2_ABI = [\n  \"function DOMAIN_SEPARATOR() view returns (bytes32)\",\n  \"function nonceBitmap(address owner, uint256 wordPosition) view returns (uint256)\",\n  \"function invalidateUnorderedNonces(uint256 wordPos, uint256 mask)\",\n  \"event UnorderedNonceInvalidation(address indexed owner, uint256 word, uint256 mask)\",\n] as const;\n\n// ---------------------------------------------------------------------------\n// ERC-8004\n//\n// Human-readable fragments copied from `IdentityRegistryUpgradeable` and\n// `ReputationRegistryUpgradeable` in erc-8004/erc-8004-contracts, the\n// implementations behind the canonical proxies (`getVersion()` reports 2.0.0).\n// Only what Tab reads and writes; the ERC-721 and UUPS surface is omitted.\n// ---------------------------------------------------------------------------\n\n/**\n * The Identity Registry: an ERC-721 whose token id is the agentId, whose\n * `tokenURI` is the agent's registration file, and whose `agentWallet`\n * metadata is the account acting for the agent. `register` mints to the\n * caller and records it as the wallet; ids are sequential from zero.\n */\nexport const ERC8004_IDENTITY_REGISTRY_ABI = [\n  \"function register() returns (uint256 agentId)\",\n  \"function register(string agentURI) returns (uint256 agentId)\",\n  \"function register(string agentURI, (string metadataKey, bytes metadataValue)[] metadata) returns (uint256 agentId)\",\n  \"function setAgentURI(uint256 agentId, string newURI)\",\n  \"function tokenURI(uint256 tokenId) view returns (string)\",\n  \"function ownerOf(uint256 tokenId) view returns (address)\",\n  \"function balanceOf(address owner) view returns (uint256)\",\n  \"function getAgentWallet(uint256 agentId) view returns (address)\",\n  \"function getMetadata(uint256 agentId, string metadataKey) view returns (bytes)\",\n  \"function setMetadata(uint256 agentId, string metadataKey, bytes metadataValue)\",\n  \"function isAuthorizedOrOwner(address spender, uint256 agentId) view returns (bool)\",\n  \"function getVersion() pure returns (string)\",\n  \"event Registered(uint256 indexed agentId, string agentURI, address indexed owner)\",\n  \"event URIUpdated(uint256 indexed agentId, string newURI, address indexed updatedBy)\",\n  \"event MetadataSet(uint256 indexed agentId, string indexed indexedMetadataKey, string metadataKey, bytes metadataValue)\",\n  \"event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)\",\n] as const;\n\n/**\n * The Reputation Registry: feedback about an agent, keyed by agentId and the\n * client that gave it, 1-indexed per client. An agent's owner or operator\n * cannot give feedback about it.\n */\nexport const ERC8004_REPUTATION_REGISTRY_ABI = [\n  \"function giveFeedback(uint256 agentId, int128 value, uint8 valueDecimals, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash)\",\n  \"function revokeFeedback(uint256 agentId, uint64 feedbackIndex)\",\n  \"function appendResponse(uint256 agentId, address clientAddress, uint64 feedbackIndex, string responseURI, bytes32 responseHash)\",\n  \"function getSummary(uint256 agentId, address[] clientAddresses, string tag1, string tag2) view returns (uint64 count, int128 summaryValue, uint8 summaryValueDecimals)\",\n  \"function readFeedback(uint256 agentId, address clientAddress, uint64 feedbackIndex) view returns (int128 value, uint8 valueDecimals, string tag1, string tag2, bool isRevoked)\",\n  \"function readAllFeedback(uint256 agentId, address[] clientAddresses, string tag1, string tag2, bool includeRevoked) view returns (address[] clients, uint64[] feedbackIndexes, int128[] values, uint8[] valueDecimals, string[] tag1s, string[] tag2s, bool[] revokedStatuses)\",\n  \"function getLastIndex(uint256 agentId, address clientAddress) view returns (uint64)\",\n  \"function getClients(uint256 agentId) view returns (address[])\",\n  \"function getIdentityRegistry() view returns (address)\",\n  \"function getVersion() pure returns (string)\",\n  \"event NewFeedback(uint256 indexed agentId, address indexed clientAddress, uint64 feedbackIndex, int128 value, uint8 valueDecimals, string indexed indexedTag1, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash)\",\n  \"event FeedbackRevoked(uint256 indexed agentId, address indexed clientAddress, uint64 indexed feedbackIndex)\",\n  \"event ResponseAppended(uint256 indexed agentId, address indexed clientAddress, uint64 feedbackIndex, address indexed responder, string responseURI, bytes32 responseHash)\",\n] as const;\n\n/** Canonical ERC-8004 event signatures, for topic filters. */\nexport const ERC8004_EVENT_SIGNATURES = {\n  Registered: \"Registered(uint256,string,address)\",\n  URIUpdated: \"URIUpdated(uint256,string,address)\",\n  MetadataSet: \"MetadataSet(uint256,string,string,bytes)\",\n  NewFeedback: \"NewFeedback(uint256,address,uint64,int128,uint8,string,string,string,string,string,bytes32)\",\n  FeedbackRevoked: \"FeedbackRevoked(uint256,address,uint64)\",\n  ResponseAppended: \"ResponseAppended(uint256,address,uint64,address,string,bytes32)\",\n} as const;\n\nexport type Erc8004EventName = keyof typeof ERC8004_EVENT_SIGNATURES;\n\n/** `topics[0]` for each ERC-8004 event, derived from its canonical signature. */\nexport const ERC8004_EVENT_TOPIC0: Readonly<Record<Erc8004EventName, Bytes32>> = Object.fromEntries(\n  Object.entries(ERC8004_EVENT_SIGNATURES).map(([name, signature]) => [name, keccak256Ascii(signature)]),\n) as Record<Erc8004EventName, Bytes32>;\n"]}

package/dist/_shared/chains.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Chain and Asset constants for Tab on Monad.
+ *
+ * Tab runs on one chain. The Agent's payment and the ledger entry happen in the
+ * same Monad transaction, so nothing in the system refers to any other chain.
+ * What this module carries is which Monad network a deployment targets and
+ * which Assets it settles in.
+ *
+ * Addresses of Tab's own contracts are deployment output and live in
+ * `deployments.json`, never here.
+ */
+import type { Address } from "./hex.js";
+/** A Monad network a Tab deployment can target. */
+export interface ChainDescriptor {
+    readonly name: string;
+    readonly chainId: number;
+    readonly rpcUrl: string;
+    readonly explorerUrl: string;
+    /** The MON faucet, testnet only. */
+    readonly faucetUrl?: string;
+}
+export declare const MONAD_MAINNET: {
+    readonly name: "Monad Mainnet";
+    readonly chainId: 143;
+    readonly rpcUrl: "https://rpc.monad.xyz";
+    readonly explorerUrl: "https://monadvision.com";
+};
+export declare const MONAD_TESTNET: {
+    readonly name: "Monad Testnet";
+    readonly chainId: 10143;
+    readonly rpcUrl: "https://testnet-rpc.monad.xyz";
+    readonly explorerUrl: "https://testnet.monadvision.com";
+    readonly faucetUrl: "https://faucet.monad.xyz";
+};
+export declare const CHAINS: {
+    readonly 143: {
+        readonly name: "Monad Mainnet";
+        readonly chainId: 143;
+        readonly rpcUrl: "https://rpc.monad.xyz";
+        readonly explorerUrl: "https://monadvision.com";
+    };
+    readonly 10143: {
+        readonly name: "Monad Testnet";
+        readonly chainId: 10143;
+        readonly rpcUrl: "https://testnet-rpc.monad.xyz";
+        readonly explorerUrl: "https://testnet.monadvision.com";
+        readonly faucetUrl: "https://faucet.monad.xyz";
+    };
+};
+export type MonadChainId = keyof typeof CHAINS;
+export declare function isMonadChainId(value: unknown): value is MonadChainId;
+export declare function chainFor(chainId: number | bigint): ChainDescriptor | undefined;
+/** Link to an address or a transaction on the explorer for a chain. */
+export declare function explorerLink(chain: ChainDescriptor, kind: "address" | "tx", hash: string): string;
+/** A stablecoin Tab settles in. Amounts everywhere are integer base units. */
+export interface AssetDescriptor {
+    readonly symbol: string;
+    readonly decimals: number;
+    readonly address: Address;
+}
+/** Canonical stablecoins on Monad Mainnet. */
+export declare const MAINNET_ASSETS: {
+    readonly USDC: {
+        readonly symbol: "USDC";
+        readonly decimals: 6;
+        readonly address: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603";
+    };
+    readonly AUSD: {
+        readonly symbol: "AUSD";
+        readonly decimals: 6;
+        readonly address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a";
+    };
+};
+/**
+ * Stablecoins on Monad Testnet. `USDC` is Circle's own testnet deployment
+ * (`name` "USDC", EIP-712 version "2", 20 USDC per address every two hours from
+ * https://faucet.circle.com). `MockUsdc`, the mintable test double the deploy
+ * script ships, is a deployment output and lives in `deployments.json`.
+ */
+export declare const TESTNET_ASSETS: {
+    readonly USDC: {
+        readonly symbol: "USDC";
+        readonly decimals: 6;
+        readonly address: "0x534b2f3A21130d7a60830c2Df862319e593943A3";
+    };
+};
+/**
+ * Uniswap's Permit2, at its canonical address on every chain it was deployed
+ * to, Monad Mainnet and Testnet included. `TabSettlement.settleWithPermit2`
+ * verifies an Agent's signature against it, so an Agent approves Permit2 once
+ * and signs thereafter.
+ */
+export declare const PERMIT2_ADDRESS: "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+/** The x402 facilitator that verifies and settles `exact` payments on Monad. */
+export declare const X402_FACILITATOR_URL: "https://x402-facilitator.molandak.org";
+/** The two ERC-8004 registries a Tab deployment reads and writes. */
+export interface Erc8004Registries {
+    /** Agent identities: an ERC-721 whose token id is the agentId and whose URI is the registration file. */
+    readonly identity: Address;
+    /** Feedback about agents, keyed by agentId and client. */
+    readonly reputation: Address;
+}
+/** The canonical ERC-8004 registries, keyed by chain id. */
+export declare const ERC8004_REGISTRIES: {
+    readonly 143: {
+        readonly identity: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432";
+        readonly reputation: "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63";
+    };
+    readonly 10143: {
+        readonly identity: "0x8004A818BFB912233c491871b3d84c89A494BD9e";
+        readonly reputation: "0x8004B663056A597Dffe9eCcC1965A193B7388713";
+    };
+};
+export declare function erc8004RegistriesFor(chainId: number | bigint): Erc8004Registries | undefined;
+export declare const PLACEHOLDER_ADDRESS: "0x0000000000000000000000000000000000000000";
+/** Formats base units of a six-decimal Asset for display, without floating point. */
+export declare function formatBaseUnits(amount: bigint, decimals: number): string;
+//# sourceMappingURL=chains.d.ts.map

package/dist/_shared/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,aAAa;;;;;CAKU,CAAC;AAErC,eAAO,MAAM,aAAa;;;;;;CAMU,CAAC;AAErC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;CAGT,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,MAAM,CAAC;AAE/C,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,GAAG,SAAS,CAG9E;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjG;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,8CAA8C;AAC9C,eAAO,MAAM,cAAc;;;;;;;;;;;CAWmC,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;CAMmC,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,8CAA0E,CAAC;AAEvG,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,EAAG,uCAAgD,CAAC;AAErF,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,yGAAyG;IACzG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB;;;;;;;;;CASuC,CAAC;AAEvE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAG5F;AAED,eAAO,MAAM,mBAAmB,EAAG,4CAAqD,CAAC;AAEzF,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOxE"}

package/dist/_shared/chains.js

@@ -0,0 +1,89 @@
+export const MONAD_MAINNET = {
+    name: "Monad Mainnet",
+    chainId: 143,
+    rpcUrl: "https://rpc.monad.xyz",
+    explorerUrl: "https://monadvision.com",
+};
+export const MONAD_TESTNET = {
+    name: "Monad Testnet",
+    chainId: 10143,
+    rpcUrl: "https://testnet-rpc.monad.xyz",
+    explorerUrl: "https://testnet.monadvision.com",
+    faucetUrl: "https://faucet.monad.xyz",
+};
+export const CHAINS = {
+    [MONAD_MAINNET.chainId]: MONAD_MAINNET,
+    [MONAD_TESTNET.chainId]: MONAD_TESTNET,
+};
+export function isMonadChainId(value) {
+    return value === MONAD_MAINNET.chainId || value === MONAD_TESTNET.chainId;
+}
+export function chainFor(chainId) {
+    const narrowed = typeof chainId === "bigint" ? Number(chainId) : chainId;
+    return isMonadChainId(narrowed) ? CHAINS[narrowed] : undefined;
+}
+/** Link to an address or a transaction on the explorer for a chain. */
+export function explorerLink(chain, kind, hash) {
+    return `${chain.explorerUrl}/${kind}/${hash}`;
+}
+/** Canonical stablecoins on Monad Mainnet. */
+export const MAINNET_ASSETS = {
+    USDC: {
+        symbol: "USDC",
+        decimals: 6,
+        address: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+    },
+    AUSD: {
+        symbol: "AUSD",
+        decimals: 6,
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+    },
+};
+/**
+ * Stablecoins on Monad Testnet. `USDC` is Circle's own testnet deployment
+ * (`name` "USDC", EIP-712 version "2", 20 USDC per address every two hours from
+ * https://faucet.circle.com). `MockUsdc`, the mintable test double the deploy
+ * script ships, is a deployment output and lives in `deployments.json`.
+ */
+export const TESTNET_ASSETS = {
+    USDC: {
+        symbol: "USDC",
+        decimals: 6,
+        address: "0x534b2f3A21130d7a60830c2Df862319e593943A3",
+    },
+};
+/**
+ * Uniswap's Permit2, at its canonical address on every chain it was deployed
+ * to, Monad Mainnet and Testnet included. `TabSettlement.settleWithPermit2`
+ * verifies an Agent's signature against it, so an Agent approves Permit2 once
+ * and signs thereafter.
+ */
+export const PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+/** The x402 facilitator that verifies and settles `exact` payments on Monad. */
+export const X402_FACILITATOR_URL = "https://x402-facilitator.molandak.org";
+/** The canonical ERC-8004 registries, keyed by chain id. */
+export const ERC8004_REGISTRIES = {
+    [MONAD_MAINNET.chainId]: {
+        identity: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
+        reputation: "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
+    },
+    [MONAD_TESTNET.chainId]: {
+        identity: "0x8004A818BFB912233c491871b3d84c89A494BD9e",
+        reputation: "0x8004B663056A597Dffe9eCcC1965A193B7388713",
+    },
+};
+export function erc8004RegistriesFor(chainId) {
+    const narrowed = typeof chainId === "bigint" ? Number(chainId) : chainId;
+    return isMonadChainId(narrowed) ? ERC8004_REGISTRIES[narrowed] : undefined;
+}
+export const PLACEHOLDER_ADDRESS = "0x0000000000000000000000000000000000000000";
+/** Formats base units of a six-decimal Asset for display, without floating point. */
+export function formatBaseUnits(amount, decimals) {
+    const negative = amount < 0n;
+    const abs = negative ? -amount : amount;
+    const scale = 10n ** BigInt(decimals);
+    const whole = abs / scale;
+    const fraction = (abs % scale).toString().padStart(decimals, "0").replace(/0+$/, "");
+    return `${negative ? "-" : ""}${whole}${fraction ? `.${fraction}` : ""}`;
+}
+//# sourceMappingURL=chains.js.map

package/dist/_shared/chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Chain and Asset constants for Tab on Monad.\n *\n * Tab runs on one chain. The Agent's payment and the ledger entry happen in the\n * same Monad transaction, so nothing in the system refers to any other chain.\n * What this module carries is which Monad network a deployment targets and\n * which Assets it settles in.\n *\n * Addresses of Tab's own contracts are deployment output and live in\n * `deployments.json`, never here.\n */\nimport type { Address } from \"./hex.js\";\n\n/** A Monad network a Tab deployment can target. */\nexport interface ChainDescriptor {\n  readonly name: string;\n  readonly chainId: number;\n  readonly rpcUrl: string;\n  readonly explorerUrl: string;\n  /** The MON faucet, testnet only. */\n  readonly faucetUrl?: string;\n}\n\nexport const MONAD_MAINNET = {\n  name: \"Monad Mainnet\",\n  chainId: 143,\n  rpcUrl: \"https://rpc.monad.xyz\",\n  explorerUrl: \"https://monadvision.com\",\n} as const satisfies ChainDescriptor;\n\nexport const MONAD_TESTNET = {\n  name: \"Monad Testnet\",\n  chainId: 10143,\n  rpcUrl: \"https://testnet-rpc.monad.xyz\",\n  explorerUrl: \"https://testnet.monadvision.com\",\n  faucetUrl: \"https://faucet.monad.xyz\",\n} as const satisfies ChainDescriptor;\n\nexport const CHAINS = {\n  [MONAD_MAINNET.chainId]: MONAD_MAINNET,\n  [MONAD_TESTNET.chainId]: MONAD_TESTNET,\n} as const;\n\nexport type MonadChainId = keyof typeof CHAINS;\n\nexport function isMonadChainId(value: unknown): value is MonadChainId {\n  return value === MONAD_MAINNET.chainId || value === MONAD_TESTNET.chainId;\n}\n\nexport function chainFor(chainId: number | bigint): ChainDescriptor | undefined {\n  const narrowed = typeof chainId === \"bigint\" ? Number(chainId) : chainId;\n  return isMonadChainId(narrowed) ? CHAINS[narrowed] : undefined;\n}\n\n/** Link to an address or a transaction on the explorer for a chain. */\nexport function explorerLink(chain: ChainDescriptor, kind: \"address\" | \"tx\", hash: string): string {\n  return `${chain.explorerUrl}/${kind}/${hash}`;\n}\n\n/** A stablecoin Tab settles in. Amounts everywhere are integer base units. */\nexport interface AssetDescriptor {\n  readonly symbol: string;\n  readonly decimals: number;\n  readonly address: Address;\n}\n\n/** Canonical stablecoins on Monad Mainnet. */\nexport const MAINNET_ASSETS = {\n  USDC: {\n    symbol: \"USDC\",\n    decimals: 6,\n    address: \"0x754704Bc059F8C67012fEd69BC8A327a5aafb603\",\n  },\n  AUSD: {\n    symbol: \"AUSD\",\n    decimals: 6,\n    address: \"0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a\",\n  },\n} as const satisfies Readonly<Record<string, AssetDescriptor>>;\n\n/**\n * Stablecoins on Monad Testnet. `USDC` is Circle's own testnet deployment\n * (`name` \"USDC\", EIP-712 version \"2\", 20 USDC per address every two hours from\n * https://faucet.circle.com). `MockUsdc`, the mintable test double the deploy\n * script ships, is a deployment output and lives in `deployments.json`.\n */\nexport const TESTNET_ASSETS = {\n  USDC: {\n    symbol: \"USDC\",\n    decimals: 6,\n    address: \"0x534b2f3A21130d7a60830c2Df862319e593943A3\",\n  },\n} as const satisfies Readonly<Record<string, AssetDescriptor>>;\n\n/**\n * Uniswap's Permit2, at its canonical address on every chain it was deployed\n * to, Monad Mainnet and Testnet included. `TabSettlement.settleWithPermit2`\n * verifies an Agent's signature against it, so an Agent approves Permit2 once\n * and signs thereafter.\n */\nexport const PERMIT2_ADDRESS = \"0x000000000022D473030F116dDEE9F6B43aC78BA3\" as const satisfies Address;\n\n/** The x402 facilitator that verifies and settles `exact` payments on Monad. */\nexport const X402_FACILITATOR_URL = \"https://x402-facilitator.molandak.org\" as const;\n\n/** The two ERC-8004 registries a Tab deployment reads and writes. */\nexport interface Erc8004Registries {\n  /** Agent identities: an ERC-721 whose token id is the agentId and whose URI is the registration file. */\n  readonly identity: Address;\n  /** Feedback about agents, keyed by agentId and client. */\n  readonly reputation: Address;\n}\n\n/** The canonical ERC-8004 registries, keyed by chain id. */\nexport const ERC8004_REGISTRIES = {\n  [MONAD_MAINNET.chainId]: {\n    identity: \"0x8004A169FB4a3325136EB29fA0ceB6D2e539a432\",\n    reputation: \"0x8004BAa17C55a88189AE136b182e5fdA19dE9b63\",\n  },\n  [MONAD_TESTNET.chainId]: {\n    identity: \"0x8004A818BFB912233c491871b3d84c89A494BD9e\",\n    reputation: \"0x8004B663056A597Dffe9eCcC1965A193B7388713\",\n  },\n} as const satisfies Readonly<Record<MonadChainId, Erc8004Registries>>;\n\nexport function erc8004RegistriesFor(chainId: number | bigint): Erc8004Registries | undefined {\n  const narrowed = typeof chainId === \"bigint\" ? Number(chainId) : chainId;\n  return isMonadChainId(narrowed) ? ERC8004_REGISTRIES[narrowed] : undefined;\n}\n\nexport const PLACEHOLDER_ADDRESS = \"0x0000000000000000000000000000000000000000\" as const;\n\n/** Formats base units of a six-decimal Asset for display, without floating point. */\nexport function formatBaseUnits(amount: bigint, decimals: number): string {\n  const negative = amount < 0n;\n  const abs = negative ? -amount : amount;\n  const scale = 10n ** BigInt(decimals);\n  const whole = abs / scale;\n  const fraction = (abs % scale).toString().padStart(decimals, \"0\").replace(/0+$/, \"\");\n  return `${negative ? \"-\" : \"\"}${whole}${fraction ? `.${fraction}` : \"\"}`;\n}\n"]}

package/dist/_shared/hex.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Minimal hexadecimal primitives.
+ *
+ * `@tabai/shared` carries no runtime dependency, so the few byte-level helpers the
+ * chain constants and the event topics need are written here against native
+ * `bigint`. Nothing in this file allocates a buffer or touches the network.
+ */
+/** A `0x`-prefixed hexadecimal string of any length. */
+export type Hex = `0x${string}`;
+/** A `0x`-prefixed 32-byte word: exactly 64 hexadecimal digits. */
+export type Bytes32 = Hex;
+/** A `0x`-prefixed 20-byte address: exactly 40 hexadecimal digits. */
+export type Address = Hex;
+/** Largest value a `uint64` field can hold: `2^64 - 1`. */
+export declare const UINT64_MAX = 18446744073709551615n;
+/** One past the largest `uint64` value: `2^64`. */
+export declare const UINT64_CEILING = 18446744073709551616n;
+/** Largest value a 32-byte word can hold: `2^256 - 1`. */
+export declare const UINT256_MAX = 115792089237316195423570985008687907853269984665640564039457584007913129639935n;
+export declare const isHex: (value: unknown) => value is Hex;
+export declare const isBytes32: (value: unknown) => value is Bytes32;
+export declare const isAddress: (value: unknown) => value is Address;
+/**
+ * Renders an unsigned integer as a lower-case 32-byte word.
+ *
+ * @throws RangeError when `value` is negative or exceeds `2^256 - 1`.
+ */
+export declare function toBytes32(value: bigint): Bytes32;
+/**
+ * Reads a 32-byte word back into an unsigned integer.
+ *
+ * @throws TypeError when `value` is not exactly 64 hexadecimal digits behind `0x`.
+ */
+export declare function fromBytes32(value: string): bigint;
+//# sourceMappingURL=hex.d.ts.map

package/dist/_shared/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../src/hex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wDAAwD;AACxD,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,EAAE,CAAC;AAEhC,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC;AAE1B,sEAAsE;AACtE,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC;AAI1B,2DAA2D;AAC3D,eAAO,MAAM,UAAU,wBAA8B,CAAC;AAEtD,mDAAmD;AACnD,eAAO,MAAM,cAAc,wBAA8B,CAAC;AAE1D,0DAA0D;AAC1D,eAAO,MAAM,WAAW,kFACkF,CAAC;AAE3G,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,GACI,CAAC;AAErD,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAA8C,CAAC;AAEnG,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAA8C,CAAC;AAEnG;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKhD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOjD"}

package/dist/_shared/hex.js

@@ -0,0 +1,40 @@
+/**
+ * Minimal hexadecimal primitives.
+ *
+ * `@tabai/shared` carries no runtime dependency, so the few byte-level helpers the
+ * chain constants and the event topics need are written here against native
+ * `bigint`. Nothing in this file allocates a buffer or touches the network.
+ */
+const HEX_SHAPE = /^0x[0-9a-fA-F]*$/;
+/** Largest value a `uint64` field can hold: `2^64 - 1`. */
+export const UINT64_MAX = 18446744073709551615n;
+/** One past the largest `uint64` value: `2^64`. */
+export const UINT64_CEILING = 18446744073709551616n;
+/** Largest value a 32-byte word can hold: `2^256 - 1`. */
+export const UINT256_MAX = 115792089237316195423570985008687907853269984665640564039457584007913129639935n;
+export const isHex = (value) => typeof value === "string" && HEX_SHAPE.test(value);
+export const isBytes32 = (value) => isHex(value) && value.length === 66;
+export const isAddress = (value) => isHex(value) && value.length === 42;
+/**
+ * Renders an unsigned integer as a lower-case 32-byte word.
+ *
+ * @throws RangeError when `value` is negative or exceeds `2^256 - 1`.
+ */
+export function toBytes32(value) {
+    if (value < 0n || value > UINT256_MAX) {
+        throw new RangeError(`toBytes32: value must be in [0, 2^256 - 1], received ${value}`);
+    }
+    return `0x${value.toString(16).padStart(64, "0")}`;
+}
+/**
+ * Reads a 32-byte word back into an unsigned integer.
+ *
+ * @throws TypeError when `value` is not exactly 64 hexadecimal digits behind `0x`.
+ */
+export function fromBytes32(value) {
+    if (!isBytes32(value)) {
+        throw new TypeError(`fromBytes32: expected a 0x-prefixed 32-byte word (66 characters), received ${JSON.stringify(value)}`);
+    }
+    return BigInt(value);
+}
+//# sourceMappingURL=hex.js.map

package/dist/_shared/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../src/hex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,qBAA2B,CAAC;AAEtD,mDAAmD;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,qBAA2B,CAAC;AAE1D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,WAAW,GACtB,+EAAwG,CAAC;AAE3G,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAgB,EAAE,CACpD,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC;AAEnG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC;AAEnG;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,KAAK,GAAG,EAAE,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;QACtC,MAAM,IAAI,UAAU,CAAC,wDAAwD,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CACjB,8EAA8E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CACtG,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC","sourcesContent":["/**\n * Minimal hexadecimal primitives.\n *\n * `@tabai/shared` carries no runtime dependency, so the few byte-level helpers the\n * chain constants and the event topics need are written here against native\n * `bigint`. Nothing in this file allocates a buffer or touches the network.\n */\n\n/** A `0x`-prefixed hexadecimal string of any length. */\nexport type Hex = `0x${string}`;\n\n/** A `0x`-prefixed 32-byte word: exactly 64 hexadecimal digits. */\nexport type Bytes32 = Hex;\n\n/** A `0x`-prefixed 20-byte address: exactly 40 hexadecimal digits. */\nexport type Address = Hex;\n\nconst HEX_SHAPE = /^0x[0-9a-fA-F]*$/;\n\n/** Largest value a `uint64` field can hold: `2^64 - 1`. */\nexport const UINT64_MAX = 18_446_744_073_709_551_615n;\n\n/** One past the largest `uint64` value: `2^64`. */\nexport const UINT64_CEILING = 18_446_744_073_709_551_616n;\n\n/** Largest value a 32-byte word can hold: `2^256 - 1`. */\nexport const UINT256_MAX =\n  115_792_089_237_316_195_423_570_985_008_687_907_853_269_984_665_640_564_039_457_584_007_913_129_639_935n;\n\nexport const isHex = (value: unknown): value is Hex =>\n  typeof value === \"string\" && HEX_SHAPE.test(value);\n\nexport const isBytes32 = (value: unknown): value is Bytes32 => isHex(value) && value.length === 66;\n\nexport const isAddress = (value: unknown): value is Address => isHex(value) && value.length === 42;\n\n/**\n * Renders an unsigned integer as a lower-case 32-byte word.\n *\n * @throws RangeError when `value` is negative or exceeds `2^256 - 1`.\n */\nexport function toBytes32(value: bigint): Bytes32 {\n  if (value < 0n || value > UINT256_MAX) {\n    throw new RangeError(`toBytes32: value must be in [0, 2^256 - 1], received ${value}`);\n  }\n  return `0x${value.toString(16).padStart(64, \"0\")}`;\n}\n\n/**\n * Reads a 32-byte word back into an unsigned integer.\n *\n * @throws TypeError when `value` is not exactly 64 hexadecimal digits behind `0x`.\n */\nexport function fromBytes32(value: string): bigint {\n  if (!isBytes32(value)) {\n    throw new TypeError(\n      `fromBytes32: expected a 0x-prefixed 32-byte word (66 characters), received ${JSON.stringify(value)}`,\n    );\n  }\n  return BigInt(value);\n}\n"]}

package/dist/_shared/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@tabai/shared` is the single source of the chain constants and the contract
+ * interface constants, so the SDK, the gateway, the registry indexer, and the
+ * dashboard cannot drift apart on any of them.
+ *
+ * The package has no internal dependency and no runtime dependency at all.
+ */
+export declare const WORKSPACE_ID: "@tabai/shared";
+export * from "./hex.js";
+export * from "./keccak256.js";
+export * from "./result.js";
+export * from "./chains.js";
+export * from "./abi.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/_shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAG,eAAwB,CAAC;AAErD,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}

package/dist/_shared/index.js

@@ -0,0 +1,14 @@
+/**
+ * `@tabai/shared` is the single source of the chain constants and the contract
+ * interface constants, so the SDK, the gateway, the registry indexer, and the
+ * dashboard cannot drift apart on any of them.
+ *
+ * The package has no internal dependency and no runtime dependency at all.
+ */
+export const WORKSPACE_ID = "@tabai/shared";
+export * from "./hex.js";
+export * from "./keccak256.js";
+export * from "./result.js";
+export * from "./chains.js";
+export * from "./abi.js";
+//# sourceMappingURL=index.js.map

package/dist/_shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,eAAwB,CAAC;AAErD,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC","sourcesContent":["/**\n * `@tabai/shared` is the single source of the chain constants and the contract\n * interface constants, so the SDK, the gateway, the registry indexer, and the\n * dashboard cannot drift apart on any of them.\n *\n * The package has no internal dependency and no runtime dependency at all.\n */\nexport const WORKSPACE_ID = \"@tabai/shared\" as const;\n\nexport * from \"./hex.js\";\nexport * from \"./keccak256.js\";\nexport * from \"./result.js\";\nexport * from \"./chains.js\";\nexport * from \"./abi.js\";\n"]}

package/dist/_shared/keccak256.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Keccak-256, written against native `bigint`.
+ *
+ * `@tabai/shared` carries zero runtime dependencies, and Keccak-256 is not
+ * SHA3-256, the two differ in their padding byte, so the platform hash
+ * primitives cannot stand in for it. The permutation below is therefore
+ * implemented here: 24 rounds of Keccak-f[1600] over 25 64-bit lanes, rate 136
+ * bytes, capacity 64 bytes, `0x01` domain padding.
+ *
+ * Correctness is pinned by published digests in `test/keccak256.test.mjs`: the
+ * empty-input digest, the `abc` digest, and the ERC-20 `Transfer` and `Approval`
+ * event topics any chain explorer shows. The permutation was additionally
+ * cross-checked against the platform SHA3-256, same permutation, same rate,
+ * different padding byte, at input lengths spanning the 136-byte block
+ * boundary. It is used only to derive a handful of event topic hashes at module
+ * load, so the `bigint` lane representation costs nothing that matters.
+ */
+import type { Bytes32 } from "./hex.js";
+/** Hashes raw bytes and renders the digest as a 32-byte word. */
+export declare function keccak256(data: Uint8Array): Bytes32;
+/**
+ * Hashes an ASCII string. Event and function signatures are ASCII by
+ * construction, so refusing anything above `0x7f` keeps encoding out of the
+ * picture entirely.
+ *
+ * @throws RangeError when `text` carries a non-ASCII code unit.
+ */
+export declare function keccak256Ascii(text: string): Bytes32;
+//# sourceMappingURL=keccak256.d.ts.map

package/dist/_shared/keccak256.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keccak256.d.ts","sourceRoot":"","sources":["../src/keccak256.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AA6FxC,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CA6BnD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYpD"}