@t2000/id 9.3.1 → 9.5.0

package/dist/index.cjs

@@ -1,6 +1,9 @@
 'use strict';
 
+var bcs = require('@mysten/sui/bcs');
+var grpc = require('@mysten/sui/grpc');
 var transactions = require('@mysten/sui/transactions');
+var utils = require('@mysten/sui/utils');
 
 // src/index.ts
 var AGENT_ID_PACKAGE_ID = process.env.AGENT_ID_PACKAGE_ID ?? "0x78d365066fb0e6468a9dcb49595e559434a53d7a12d845f776bcda76b4d15451";
@@ -69,6 +72,34 @@ function buildRenounceOwnershipTx(agent) {
   });
   return tx;
 }
+async function getAgentRecord(address, opts = {}) {
+  const network = opts.network ?? "mainnet";
+  const client = opts.client ?? new grpc.SuiGrpcClient({
+    baseUrl: network === "testnet" ? "https://fullnode.testnet.sui.io" : "https://fullnode.mainnet.sui.io",
+    network
+  });
+  const reg = await client.core.getObject({
+    objectId: AGENT_ID_REGISTRY_ID,
+    include: { json: true }
+  });
+  const tableId = reg.object?.json?.agents?.id;
+  if (!tableId) return null;
+  const fieldId = utils.deriveDynamicFieldID(
+    tableId,
+    "address",
+    bcs.bcs.Address.serialize(address).toBytes()
+  );
+  try {
+    const obj = await client.core.getObject({
+      objectId: fieldId,
+      include: { json: true }
+    });
+    const rec = obj.object?.json?.value;
+    return rec?.agent ? rec : null;
+  } catch {
+    return null;
+  }
+}
 function buildSetActiveTx(agent, active) {
   const tx = new transactions.Transaction();
   tx.moveCall({
@@ -91,5 +122,6 @@ exports.buildRenounceOwnershipTx = buildRenounceOwnershipTx;
 exports.buildSetActiveTx = buildSetActiveTx;
 exports.buildSetPendingOwnerTx = buildSetPendingOwnerTx;
 exports.buildUpdateTx = buildUpdateTx;
+exports.getAgentRecord = getAgentRecord;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["Transaction"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Transaction } from '@mysten/sui/transactions';\n\n/**\n * @t2000/id — client for the `agent_id::registry` Move package (Agent ID\n * Phase B). These builders construct UNSIGNED transactions calling the on-chain\n * registry; the caller signs (the agent's keypair for register/update/active;\n * the proposed owner for confirm) and may sponsor gas (the agent is the sender,\n * so `sender == agent` auth holds; a SUI-funded t2000 account co-signs gas).\n *\n * Deployed on Sui mainnet 2026-06-29. Override via env for testnet/dev.\n */\n\n/** The published `agent_id` package id — the LATEST version (v2, the\n *  2026-07-09 additive upgrade that added `renounce_ownership`; the shared\n *  Registry object is unchanged). The original v1 package\n *  (`0x7669be20…be9a45e9`) remains callable for its own functions. */\nexport const AGENT_ID_PACKAGE_ID =\n  process.env.AGENT_ID_PACKAGE_ID ??\n  '0x78d365066fb0e6468a9dcb49595e559434a53d7a12d845f776bcda76b4d15451';\n\n/** The shared `Registry` object id. */\nexport const AGENT_ID_REGISTRY_ID =\n  process.env.AGENT_ID_REGISTRY_ID ??\n  '0xf41683aa9f4c121f34e4082c35180b0efdbd6d5293e3c88b1bcfa45ddf5c4119';\n\nconst CLOCK_ID = '0x6';\nconst MODULE = 'registry';\n\n/** The mutable registration payload. `update` is full-replace — supply the\n *  complete desired state (omitted fields clear on-chain). */\nexport interface AgentRegistration {\n  mcpEndpoint?: string | null;\n  paymentMethods?: string[];\n  did?: string | null;\n  metadataUri?: string | null;\n}\n\nfunction registrationArgs(tx: Transaction, reg: AgentRegistration) {\n  return [\n    tx.object(AGENT_ID_REGISTRY_ID),\n    tx.pure.option('string', reg.mcpEndpoint ?? null),\n    tx.pure.vector('string', reg.paymentMethods ?? []),\n    tx.pure.option('string', reg.did ?? null),\n    tx.pure.option('string', reg.metadataUri ?? null),\n    tx.object(CLOCK_ID),\n  ];\n}\n\n/** Register the SIGNER as an agent (self-sovereign: `sender == agent`). */\nexport function buildRegisterTx(reg: AgentRegistration = {}): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::register`,\n    arguments: registrationArgs(tx, reg),\n  });\n  return tx;\n}\n\n/** Update the signer's record (full-replace). */\nexport function buildUpdateTx(reg: AgentRegistration = {}): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::update`,\n    arguments: registrationArgs(tx, reg),\n  });\n  return tx;\n}\n\n/** The agent (signer) proposes an owner; nothing binds until the owner confirms. */\nexport function buildSetPendingOwnerTx(owner: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::set_pending_owner`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(owner),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** The proposed owner (signer) confirms ownership of `agent`. */\nexport function buildConfirmOwnershipTx(agent: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::confirm_ownership`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** The confirmed owner (signer) renounces ownership of `agent` — the record\n *  returns to autonomous (`owner = none`). Re-linking is the normal two-sided\n *  flow (the agent proposes, the owner confirms). Requires package v2+. */\nexport function buildRenounceOwnershipTx(agent: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::renounce_ownership`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** Toggle an agent's active flag (signer must be the agent or its owner). */\nexport function buildSetActiveTx(agent: string, active: boolean): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::set_active`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.pure.bool(active),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["Transaction","SuiGrpcClient","deriveDynamicFieldID","bcs"],"mappings":"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","file":"index.cjs","sourcesContent":["import { bcs } from '@mysten/sui/bcs';\nimport { SuiGrpcClient } from '@mysten/sui/grpc';\nimport { Transaction } from '@mysten/sui/transactions';\nimport { deriveDynamicFieldID } from '@mysten/sui/utils';\n\n/**\n * @t2000/id — client for the `agent_id::registry` Move package (Agent ID\n * Phase B). These builders construct UNSIGNED transactions calling the on-chain\n * registry; the caller signs (the agent's keypair for register/update/active;\n * the proposed owner for confirm) and may sponsor gas (the agent is the sender,\n * so `sender == agent` auth holds; a SUI-funded t2000 account co-signs gas).\n *\n * Deployed on Sui mainnet 2026-06-29. Override via env for testnet/dev.\n */\n\n/** The published `agent_id` package id — the LATEST version (v2, the\n *  2026-07-09 additive upgrade that added `renounce_ownership`; the shared\n *  Registry object is unchanged). The original v1 package\n *  (`0x7669be20…be9a45e9`) remains callable for its own functions. */\nexport const AGENT_ID_PACKAGE_ID =\n  process.env.AGENT_ID_PACKAGE_ID ??\n  '0x78d365066fb0e6468a9dcb49595e559434a53d7a12d845f776bcda76b4d15451';\n\n/** The shared `Registry` object id. */\nexport const AGENT_ID_REGISTRY_ID =\n  process.env.AGENT_ID_REGISTRY_ID ??\n  '0xf41683aa9f4c121f34e4082c35180b0efdbd6d5293e3c88b1bcfa45ddf5c4119';\n\nconst CLOCK_ID = '0x6';\nconst MODULE = 'registry';\n\n/** The mutable registration payload. `update` is full-replace — supply the\n *  complete desired state (omitted fields clear on-chain). */\nexport interface AgentRegistration {\n  mcpEndpoint?: string | null;\n  paymentMethods?: string[];\n  did?: string | null;\n  metadataUri?: string | null;\n}\n\nfunction registrationArgs(tx: Transaction, reg: AgentRegistration) {\n  return [\n    tx.object(AGENT_ID_REGISTRY_ID),\n    tx.pure.option('string', reg.mcpEndpoint ?? null),\n    tx.pure.vector('string', reg.paymentMethods ?? []),\n    tx.pure.option('string', reg.did ?? null),\n    tx.pure.option('string', reg.metadataUri ?? null),\n    tx.object(CLOCK_ID),\n  ];\n}\n\n/** Register the SIGNER as an agent (self-sovereign: `sender == agent`). */\nexport function buildRegisterTx(reg: AgentRegistration = {}): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::register`,\n    arguments: registrationArgs(tx, reg),\n  });\n  return tx;\n}\n\n/** Update the signer's record (full-replace). */\nexport function buildUpdateTx(reg: AgentRegistration = {}): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::update`,\n    arguments: registrationArgs(tx, reg),\n  });\n  return tx;\n}\n\n/** The agent (signer) proposes an owner; nothing binds until the owner confirms. */\nexport function buildSetPendingOwnerTx(owner: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::set_pending_owner`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(owner),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** The proposed owner (signer) confirms ownership of `agent`. */\nexport function buildConfirmOwnershipTx(agent: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::confirm_ownership`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** The confirmed owner (signer) renounces ownership of `agent` — the record\n *  returns to autonomous (`owner = none`). Re-linking is the normal two-sided\n *  flow (the agent proposes, the owner confirms). Requires package v2+. */\nexport function buildRenounceOwnershipTx(agent: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::renounce_ownership`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** An agent's on-chain registry record (registry Table dynamic field),\n *  field names as stored by the Move package. */\nexport interface OnChainAgentRecord {\n  agent: string;\n  mcp_endpoint?: string | null;\n  payment_methods?: string[] | null;\n  did?: string | null;\n  metadata_uri?: string | null;\n}\n\n/**\n * Read one agent's registry record. Returns `null` when the address is not\n * registered. gRPC only (JSON-RPC is deactivated July 31, 2026).\n *\n * Callers that already hold a `SuiGrpcClient` should pass it; otherwise a\n * mainnet client is constructed per call.\n */\nexport async function getAgentRecord(\n  address: string,\n  opts: { client?: SuiGrpcClient; network?: 'mainnet' | 'testnet' } = {},\n): Promise<OnChainAgentRecord | null> {\n  const network = opts.network ?? 'mainnet';\n  const client =\n    opts.client ??\n    new SuiGrpcClient({\n      baseUrl:\n        network === 'testnet'\n          ? 'https://fullnode.testnet.sui.io'\n          : 'https://fullnode.mainnet.sui.io',\n      network,\n    });\n  const reg = await client.core.getObject({\n    objectId: AGENT_ID_REGISTRY_ID,\n    include: { json: true },\n  });\n  const tableId = (reg.object?.json as { agents?: { id?: string } } | undefined)\n    ?.agents?.id;\n  if (!tableId) return null;\n  const fieldId = deriveDynamicFieldID(\n    tableId,\n    'address',\n    bcs.Address.serialize(address).toBytes(),\n  );\n  try {\n    const obj = await client.core.getObject({\n      objectId: fieldId,\n      include: { json: true },\n    });\n    const rec = (obj.object?.json as { value?: OnChainAgentRecord } | undefined)\n      ?.value;\n    return rec?.agent ? rec : null;\n  } catch {\n    // Field object absent → not registered.\n    return null;\n  }\n}\n\n/** Toggle an agent's active flag (signer must be the agent or its owner). */\nexport function buildSetActiveTx(agent: string, active: boolean): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::set_active`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.pure.bool(active),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n"]}

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { Transaction } from '@mysten/sui/transactions';
 
 /**
@@ -36,7 +37,27 @@ declare function buildConfirmOwnershipTx(agent: string): Transaction;
  *  returns to autonomous (`owner = none`). Re-linking is the normal two-sided
  *  flow (the agent proposes, the owner confirms). Requires package v2+. */
 declare function buildRenounceOwnershipTx(agent: string): Transaction;
+/** An agent's on-chain registry record (registry Table dynamic field),
+ *  field names as stored by the Move package. */
+interface OnChainAgentRecord {
+    agent: string;
+    mcp_endpoint?: string | null;
+    payment_methods?: string[] | null;
+    did?: string | null;
+    metadata_uri?: string | null;
+}
+/**
+ * Read one agent's registry record. Returns `null` when the address is not
+ * registered. gRPC only (JSON-RPC is deactivated July 31, 2026).
+ *
+ * Callers that already hold a `SuiGrpcClient` should pass it; otherwise a
+ * mainnet client is constructed per call.
+ */
+declare function getAgentRecord(address: string, opts?: {
+    client?: SuiGrpcClient;
+    network?: 'mainnet' | 'testnet';
+}): Promise<OnChainAgentRecord | null>;
 /** Toggle an agent's active flag (signer must be the agent or its owner). */
 declare function buildSetActiveTx(agent: string, active: boolean): Transaction;
 
-export { AGENT_ID_PACKAGE_ID, AGENT_ID_REGISTRY_ID, type AgentRegistration, buildConfirmOwnershipTx, buildRegisterTx, buildRenounceOwnershipTx, buildSetActiveTx, buildSetPendingOwnerTx, buildUpdateTx };
+export { AGENT_ID_PACKAGE_ID, AGENT_ID_REGISTRY_ID, type AgentRegistration, type OnChainAgentRecord, buildConfirmOwnershipTx, buildRegisterTx, buildRenounceOwnershipTx, buildSetActiveTx, buildSetPendingOwnerTx, buildUpdateTx, getAgentRecord };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { Transaction } from '@mysten/sui/transactions';
 
 /**
@@ -36,7 +37,27 @@ declare function buildConfirmOwnershipTx(agent: string): Transaction;
  *  returns to autonomous (`owner = none`). Re-linking is the normal two-sided
  *  flow (the agent proposes, the owner confirms). Requires package v2+. */
 declare function buildRenounceOwnershipTx(agent: string): Transaction;
+/** An agent's on-chain registry record (registry Table dynamic field),
+ *  field names as stored by the Move package. */
+interface OnChainAgentRecord {
+    agent: string;
+    mcp_endpoint?: string | null;
+    payment_methods?: string[] | null;
+    did?: string | null;
+    metadata_uri?: string | null;
+}
+/**
+ * Read one agent's registry record. Returns `null` when the address is not
+ * registered. gRPC only (JSON-RPC is deactivated July 31, 2026).
+ *
+ * Callers that already hold a `SuiGrpcClient` should pass it; otherwise a
+ * mainnet client is constructed per call.
+ */
+declare function getAgentRecord(address: string, opts?: {
+    client?: SuiGrpcClient;
+    network?: 'mainnet' | 'testnet';
+}): Promise<OnChainAgentRecord | null>;
 /** Toggle an agent's active flag (signer must be the agent or its owner). */
 declare function buildSetActiveTx(agent: string, active: boolean): Transaction;
 
-export { AGENT_ID_PACKAGE_ID, AGENT_ID_REGISTRY_ID, type AgentRegistration, buildConfirmOwnershipTx, buildRegisterTx, buildRenounceOwnershipTx, buildSetActiveTx, buildSetPendingOwnerTx, buildUpdateTx };
+export { AGENT_ID_PACKAGE_ID, AGENT_ID_REGISTRY_ID, type AgentRegistration, type OnChainAgentRecord, buildConfirmOwnershipTx, buildRegisterTx, buildRenounceOwnershipTx, buildSetActiveTx, buildSetPendingOwnerTx, buildUpdateTx, getAgentRecord };

package/dist/index.js

@@ -1,4 +1,7 @@
+import { bcs } from '@mysten/sui/bcs';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { Transaction } from '@mysten/sui/transactions';
+import { deriveDynamicFieldID } from '@mysten/sui/utils';
 
 // src/index.ts
 var AGENT_ID_PACKAGE_ID = process.env.AGENT_ID_PACKAGE_ID ?? "0x78d365066fb0e6468a9dcb49595e559434a53d7a12d845f776bcda76b4d15451";
@@ -67,6 +70,34 @@ function buildRenounceOwnershipTx(agent) {
   });
   return tx;
 }
+async function getAgentRecord(address, opts = {}) {
+  const network = opts.network ?? "mainnet";
+  const client = opts.client ?? new SuiGrpcClient({
+    baseUrl: network === "testnet" ? "https://fullnode.testnet.sui.io" : "https://fullnode.mainnet.sui.io",
+    network
+  });
+  const reg = await client.core.getObject({
+    objectId: AGENT_ID_REGISTRY_ID,
+    include: { json: true }
+  });
+  const tableId = reg.object?.json?.agents?.id;
+  if (!tableId) return null;
+  const fieldId = deriveDynamicFieldID(
+    tableId,
+    "address",
+    bcs.Address.serialize(address).toBytes()
+  );
+  try {
+    const obj = await client.core.getObject({
+      objectId: fieldId,
+      include: { json: true }
+    });
+    const rec = obj.object?.json?.value;
+    return rec?.agent ? rec : null;
+  } catch {
+    return null;
+  }
+}
 function buildSetActiveTx(agent, active) {
   const tx = new Transaction();
   tx.moveCall({
@@ -81,6 +112,6 @@ function buildSetActiveTx(agent, active) {
   return tx;
 }
 
-export { AGENT_ID_PACKAGE_ID, AGENT_ID_REGISTRY_ID, buildConfirmOwnershipTx, buildRegisterTx, buildRenounceOwnershipTx, buildSetActiveTx, buildSetPendingOwnerTx, buildUpdateTx };
+export { AGENT_ID_PACKAGE_ID, AGENT_ID_REGISTRY_ID, buildConfirmOwnershipTx, buildRegisterTx, buildRenounceOwnershipTx, buildSetActiveTx, buildSetPendingOwnerTx, buildUpdateTx, getAgentRecord };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Transaction } from '@mysten/sui/transactions';\n\n/**\n * @t2000/id — client for the `agent_id::registry` Move package (Agent ID\n * Phase B). These builders construct UNSIGNED transactions calling the on-chain\n * registry; the caller signs (the agent's keypair for register/update/active;\n * the proposed owner for confirm) and may sponsor gas (the agent is the sender,\n * so `sender == agent` auth holds; a SUI-funded t2000 account co-signs gas).\n *\n * Deployed on Sui mainnet 2026-06-29. Override via env for testnet/dev.\n */\n\n/** The published `agent_id` package id — the LATEST version (v2, the\n *  2026-07-09 additive upgrade that added `renounce_ownership`; the shared\n *  Registry object is unchanged). The original v1 package\n *  (`0x7669be20…be9a45e9`) remains callable for its own functions. */\nexport const AGENT_ID_PACKAGE_ID =\n  process.env.AGENT_ID_PACKAGE_ID ??\n  '0x78d365066fb0e6468a9dcb49595e559434a53d7a12d845f776bcda76b4d15451';\n\n/** The shared `Registry` object id. */\nexport const AGENT_ID_REGISTRY_ID =\n  process.env.AGENT_ID_REGISTRY_ID ??\n  '0xf41683aa9f4c121f34e4082c35180b0efdbd6d5293e3c88b1bcfa45ddf5c4119';\n\nconst CLOCK_ID = '0x6';\nconst MODULE = 'registry';\n\n/** The mutable registration payload. `update` is full-replace — supply the\n *  complete desired state (omitted fields clear on-chain). */\nexport interface AgentRegistration {\n  mcpEndpoint?: string | null;\n  paymentMethods?: string[];\n  did?: string | null;\n  metadataUri?: string | null;\n}\n\nfunction registrationArgs(tx: Transaction, reg: AgentRegistration) {\n  return [\n    tx.object(AGENT_ID_REGISTRY_ID),\n    tx.pure.option('string', reg.mcpEndpoint ?? null),\n    tx.pure.vector('string', reg.paymentMethods ?? []),\n    tx.pure.option('string', reg.did ?? null),\n    tx.pure.option('string', reg.metadataUri ?? null),\n    tx.object(CLOCK_ID),\n  ];\n}\n\n/** Register the SIGNER as an agent (self-sovereign: `sender == agent`). */\nexport function buildRegisterTx(reg: AgentRegistration = {}): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::register`,\n    arguments: registrationArgs(tx, reg),\n  });\n  return tx;\n}\n\n/** Update the signer's record (full-replace). */\nexport function buildUpdateTx(reg: AgentRegistration = {}): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::update`,\n    arguments: registrationArgs(tx, reg),\n  });\n  return tx;\n}\n\n/** The agent (signer) proposes an owner; nothing binds until the owner confirms. */\nexport function buildSetPendingOwnerTx(owner: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::set_pending_owner`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(owner),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** The proposed owner (signer) confirms ownership of `agent`. */\nexport function buildConfirmOwnershipTx(agent: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::confirm_ownership`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** The confirmed owner (signer) renounces ownership of `agent` — the record\n *  returns to autonomous (`owner = none`). Re-linking is the normal two-sided\n *  flow (the agent proposes, the owner confirms). Requires package v2+. */\nexport function buildRenounceOwnershipTx(agent: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::renounce_ownership`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** Toggle an agent's active flag (signer must be the agent or its owner). */\nexport function buildSetActiveTx(agent: string, active: boolean): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::set_active`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.pure.bool(active),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { bcs } from '@mysten/sui/bcs';\nimport { SuiGrpcClient } from '@mysten/sui/grpc';\nimport { Transaction } from '@mysten/sui/transactions';\nimport { deriveDynamicFieldID } from '@mysten/sui/utils';\n\n/**\n * @t2000/id — client for the `agent_id::registry` Move package (Agent ID\n * Phase B). These builders construct UNSIGNED transactions calling the on-chain\n * registry; the caller signs (the agent's keypair for register/update/active;\n * the proposed owner for confirm) and may sponsor gas (the agent is the sender,\n * so `sender == agent` auth holds; a SUI-funded t2000 account co-signs gas).\n *\n * Deployed on Sui mainnet 2026-06-29. Override via env for testnet/dev.\n */\n\n/** The published `agent_id` package id — the LATEST version (v2, the\n *  2026-07-09 additive upgrade that added `renounce_ownership`; the shared\n *  Registry object is unchanged). The original v1 package\n *  (`0x7669be20…be9a45e9`) remains callable for its own functions. */\nexport const AGENT_ID_PACKAGE_ID =\n  process.env.AGENT_ID_PACKAGE_ID ??\n  '0x78d365066fb0e6468a9dcb49595e559434a53d7a12d845f776bcda76b4d15451';\n\n/** The shared `Registry` object id. */\nexport const AGENT_ID_REGISTRY_ID =\n  process.env.AGENT_ID_REGISTRY_ID ??\n  '0xf41683aa9f4c121f34e4082c35180b0efdbd6d5293e3c88b1bcfa45ddf5c4119';\n\nconst CLOCK_ID = '0x6';\nconst MODULE = 'registry';\n\n/** The mutable registration payload. `update` is full-replace — supply the\n *  complete desired state (omitted fields clear on-chain). */\nexport interface AgentRegistration {\n  mcpEndpoint?: string | null;\n  paymentMethods?: string[];\n  did?: string | null;\n  metadataUri?: string | null;\n}\n\nfunction registrationArgs(tx: Transaction, reg: AgentRegistration) {\n  return [\n    tx.object(AGENT_ID_REGISTRY_ID),\n    tx.pure.option('string', reg.mcpEndpoint ?? null),\n    tx.pure.vector('string', reg.paymentMethods ?? []),\n    tx.pure.option('string', reg.did ?? null),\n    tx.pure.option('string', reg.metadataUri ?? null),\n    tx.object(CLOCK_ID),\n  ];\n}\n\n/** Register the SIGNER as an agent (self-sovereign: `sender == agent`). */\nexport function buildRegisterTx(reg: AgentRegistration = {}): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::register`,\n    arguments: registrationArgs(tx, reg),\n  });\n  return tx;\n}\n\n/** Update the signer's record (full-replace). */\nexport function buildUpdateTx(reg: AgentRegistration = {}): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::update`,\n    arguments: registrationArgs(tx, reg),\n  });\n  return tx;\n}\n\n/** The agent (signer) proposes an owner; nothing binds until the owner confirms. */\nexport function buildSetPendingOwnerTx(owner: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::set_pending_owner`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(owner),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** The proposed owner (signer) confirms ownership of `agent`. */\nexport function buildConfirmOwnershipTx(agent: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::confirm_ownership`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** The confirmed owner (signer) renounces ownership of `agent` — the record\n *  returns to autonomous (`owner = none`). Re-linking is the normal two-sided\n *  flow (the agent proposes, the owner confirms). Requires package v2+. */\nexport function buildRenounceOwnershipTx(agent: string): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::renounce_ownership`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n\n/** An agent's on-chain registry record (registry Table dynamic field),\n *  field names as stored by the Move package. */\nexport interface OnChainAgentRecord {\n  agent: string;\n  mcp_endpoint?: string | null;\n  payment_methods?: string[] | null;\n  did?: string | null;\n  metadata_uri?: string | null;\n}\n\n/**\n * Read one agent's registry record. Returns `null` when the address is not\n * registered. gRPC only (JSON-RPC is deactivated July 31, 2026).\n *\n * Callers that already hold a `SuiGrpcClient` should pass it; otherwise a\n * mainnet client is constructed per call.\n */\nexport async function getAgentRecord(\n  address: string,\n  opts: { client?: SuiGrpcClient; network?: 'mainnet' | 'testnet' } = {},\n): Promise<OnChainAgentRecord | null> {\n  const network = opts.network ?? 'mainnet';\n  const client =\n    opts.client ??\n    new SuiGrpcClient({\n      baseUrl:\n        network === 'testnet'\n          ? 'https://fullnode.testnet.sui.io'\n          : 'https://fullnode.mainnet.sui.io',\n      network,\n    });\n  const reg = await client.core.getObject({\n    objectId: AGENT_ID_REGISTRY_ID,\n    include: { json: true },\n  });\n  const tableId = (reg.object?.json as { agents?: { id?: string } } | undefined)\n    ?.agents?.id;\n  if (!tableId) return null;\n  const fieldId = deriveDynamicFieldID(\n    tableId,\n    'address',\n    bcs.Address.serialize(address).toBytes(),\n  );\n  try {\n    const obj = await client.core.getObject({\n      objectId: fieldId,\n      include: { json: true },\n    });\n    const rec = (obj.object?.json as { value?: OnChainAgentRecord } | undefined)\n      ?.value;\n    return rec?.agent ? rec : null;\n  } catch {\n    // Field object absent → not registered.\n    return null;\n  }\n}\n\n/** Toggle an agent's active flag (signer must be the agent or its owner). */\nexport function buildSetActiveTx(agent: string, active: boolean): Transaction {\n  const tx = new Transaction();\n  tx.moveCall({\n    target: `${AGENT_ID_PACKAGE_ID}::${MODULE}::set_active`,\n    arguments: [\n      tx.object(AGENT_ID_REGISTRY_ID),\n      tx.pure.address(agent),\n      tx.pure.bool(active),\n      tx.object(CLOCK_ID),\n    ],\n  });\n  return tx;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t2000/id",
-  "version": "9.3.1",
+  "version": "9.5.0",
   "description": "Agent ID — on-chain agent identity registry client for the t2000 stack (Sui). Build register/update/ownership/active transactions against the agent_id::registry Move package.",
   "type": "module",
   "main": "./dist/index.cjs",