@agent-fuel/sdk 0.1.0 → 0.1.1

package/dist/index.d.cts

@@ -108,6 +108,9 @@ declare class AgentFuel {
     getPolicy(ref?: VaultRef): Promise<SpendPolicyAccount>;
     checkService(serviceAuthority: Pubkeyish): Promise<ServiceRegistryAccount>;
     spend(args: SpendArgs): Promise<SpendResult>;
+    computeScore(): Promise<{
+        signature: string;
+    }>;
     onEvent(callback: (frame: LiveEventFrame) => void, options?: OnEventOptions): Subscription;
 }
 
@@ -125,6 +128,16 @@ declare function createAssociatedTokenAccountIdempotentInstruction(payer: Public
 declare function vaultPda(owner: Pubkeyish, agent: Pubkeyish): PublicKey;
 declare function policyPda(vault: Pubkeyish): PublicKey;
 declare function serviceRegistryPda(serviceAuthority: Pubkeyish): PublicKey;
+declare function agentProfilePda(agent: Pubkeyish): PublicKey;
+/** PDA used by `record_payment` to track the agent ↔ service pair. The seeds
+ *  are the *PDAs* of the agent profile and service registry, not the raw
+ *  authority pubkeys — match the on-chain Anchor account constraint. */
+declare function agentServiceLinkPda(agentProfile: Pubkeyish, serviceRegistry: Pubkeyish): PublicKey;
+/** Existence-as-signal: a `ReceiptUsed` PDA at `[b"receipt", hash]` proves
+ *  the receipt has been recorded. `record_payment`'s `init` constraint (not
+ *  `init_if_needed`) means a duplicate hash fails with `AccountAlreadyInUse`,
+ *  which is the chain-side replay defence. */
+declare function receiptUsedPda(receiptHash: Uint8Array): PublicKey;
 
 declare class AgentFuelError extends Error {
     constructor(message: string);
@@ -172,6 +185,44 @@ declare class NotWhitelistedError extends SpendPolicyError {
     readonly service: string;
     constructor(service: string);
 }
+declare class RecordPaymentError extends AgentFuelError {
+    constructor(message: string);
+}
+declare class ReceiptAlreadyRecordedError extends RecordPaymentError {
+    readonly receiptHash: Uint8Array;
+    constructor(receiptHash: Uint8Array);
+}
+declare class ServiceInactiveError extends RecordPaymentError {
+    readonly service: string;
+    constructor(service: string);
+}
+
+type RecordPaymentArgs = {
+    /** Service authority keypair. Signs the tx and pays the fee. Must match
+     *  the same keypair that was registered on chain as the service authority. */
+    service: Keypair;
+    /** Agent identity pubkey (NOT the AgentProfile PDA — we derive that). */
+    agent: Pubkeyish;
+    /** Amount in micro-USDC (1_000_000 = 1 USDC). */
+    amountUsdc: number;
+    /** 32-byte hash that uniquely identifies this payment. Common choice:
+     *  `sha256(spendTxSignature)` — the spend signature is unique on chain,
+     *  so its hash is too. The chain enforces single-use via `init` on the
+     *  ReceiptUsed PDA; resubmitting the same hash fails with AccountAlreadyInUse. */
+    receiptHash: Uint8Array;
+    connection: Connection;
+};
+type RecordPaymentResult = {
+    signature: string;
+};
+declare function recordPayment(args: RecordPaymentArgs): Promise<RecordPaymentResult>;
+
+type SubscribeOptions = {
+    onFrame: (frame: LiveEventFrame) => void;
+    onStatus?: (status: LiveStatus) => void;
+};
+declare function subscribeService(apiBase: string, servicePubkey: string, opts: SubscribeOptions): Subscription;
+declare function subscribeVault(apiBase: string, vaultPubkey: string, opts: SubscribeOptions): Subscription;
 
 type PaymentRequirement = {
     recipient: string;
@@ -190,4 +241,4 @@ declare class PaymentParseError extends AgentFuelError {
 }
 declare function paymentRequired(fuel: AgentFuel, opts?: PaymentRequiredOptions): FetchLike;
 
-export { ASSOCIATED_TOKEN_PROGRAM_ID, AccountNotFoundError, AgentFuel, AgentFuelError, type AgentFuelOptions, type Cluster, type CreditVaultAccount, type FetchLike, HourlyLimitExceededError, HttpError, LifetimeLimitExceededError, type LiveEventFrame, type LiveStatus, NotWhitelistedError, type OnEventOptions, OwnerNotConfiguredError, PROGRAM_IDS, PaymentParseError, type PaymentRequiredOptions, type PaymentRequirement, PerTxLimitExceededError, type Pubkeyish, type ReputationLookup, SLOTS_PER_HOUR, type ServiceCategory, type ServiceRegistryAccount, type SpendArgs, type SpendPolicyAccount, SpendPolicyError, type SpendResult, type Subscription, TOKEN_PROGRAM_ID, VaultFrozenError, type VaultRef, ZeroAmountError, createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddress, paymentRequired, policyPda, serviceRegistryPda, vaultPda };
+export { ASSOCIATED_TOKEN_PROGRAM_ID, AccountNotFoundError, AgentFuel, AgentFuelError, type AgentFuelOptions, type Cluster, type CreditVaultAccount, type FetchLike, HourlyLimitExceededError, HttpError, LifetimeLimitExceededError, type LiveEventFrame, type LiveStatus, NotWhitelistedError, type OnEventOptions, OwnerNotConfiguredError, PROGRAM_IDS, PaymentParseError, type PaymentRequiredOptions, type PaymentRequirement, PerTxLimitExceededError, type Pubkeyish, ReceiptAlreadyRecordedError, type RecordPaymentArgs, RecordPaymentError, type RecordPaymentResult, type ReputationLookup, SLOTS_PER_HOUR, type ServiceCategory, ServiceInactiveError, type ServiceRegistryAccount, type SpendArgs, type SpendPolicyAccount, SpendPolicyError, type SpendResult, type SubscribeOptions, type Subscription, TOKEN_PROGRAM_ID, VaultFrozenError, type VaultRef, ZeroAmountError, agentProfilePda, agentServiceLinkPda, createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddress, paymentRequired, policyPda, receiptUsedPda, recordPayment, serviceRegistryPda, subscribeService, subscribeVault, vaultPda };

package/dist/index.d.ts

@@ -108,6 +108,9 @@ declare class AgentFuel {
     getPolicy(ref?: VaultRef): Promise<SpendPolicyAccount>;
     checkService(serviceAuthority: Pubkeyish): Promise<ServiceRegistryAccount>;
     spend(args: SpendArgs): Promise<SpendResult>;
+    computeScore(): Promise<{
+        signature: string;
+    }>;
     onEvent(callback: (frame: LiveEventFrame) => void, options?: OnEventOptions): Subscription;
 }
 
@@ -125,6 +128,16 @@ declare function createAssociatedTokenAccountIdempotentInstruction(payer: Public
 declare function vaultPda(owner: Pubkeyish, agent: Pubkeyish): PublicKey;
 declare function policyPda(vault: Pubkeyish): PublicKey;
 declare function serviceRegistryPda(serviceAuthority: Pubkeyish): PublicKey;
+declare function agentProfilePda(agent: Pubkeyish): PublicKey;
+/** PDA used by `record_payment` to track the agent ↔ service pair. The seeds
+ *  are the *PDAs* of the agent profile and service registry, not the raw
+ *  authority pubkeys — match the on-chain Anchor account constraint. */
+declare function agentServiceLinkPda(agentProfile: Pubkeyish, serviceRegistry: Pubkeyish): PublicKey;
+/** Existence-as-signal: a `ReceiptUsed` PDA at `[b"receipt", hash]` proves
+ *  the receipt has been recorded. `record_payment`'s `init` constraint (not
+ *  `init_if_needed`) means a duplicate hash fails with `AccountAlreadyInUse`,
+ *  which is the chain-side replay defence. */
+declare function receiptUsedPda(receiptHash: Uint8Array): PublicKey;
 
 declare class AgentFuelError extends Error {
     constructor(message: string);
@@ -172,6 +185,44 @@ declare class NotWhitelistedError extends SpendPolicyError {
     readonly service: string;
     constructor(service: string);
 }
+declare class RecordPaymentError extends AgentFuelError {
+    constructor(message: string);
+}
+declare class ReceiptAlreadyRecordedError extends RecordPaymentError {
+    readonly receiptHash: Uint8Array;
+    constructor(receiptHash: Uint8Array);
+}
+declare class ServiceInactiveError extends RecordPaymentError {
+    readonly service: string;
+    constructor(service: string);
+}
+
+type RecordPaymentArgs = {
+    /** Service authority keypair. Signs the tx and pays the fee. Must match
+     *  the same keypair that was registered on chain as the service authority. */
+    service: Keypair;
+    /** Agent identity pubkey (NOT the AgentProfile PDA — we derive that). */
+    agent: Pubkeyish;
+    /** Amount in micro-USDC (1_000_000 = 1 USDC). */
+    amountUsdc: number;
+    /** 32-byte hash that uniquely identifies this payment. Common choice:
+     *  `sha256(spendTxSignature)` — the spend signature is unique on chain,
+     *  so its hash is too. The chain enforces single-use via `init` on the
+     *  ReceiptUsed PDA; resubmitting the same hash fails with AccountAlreadyInUse. */
+    receiptHash: Uint8Array;
+    connection: Connection;
+};
+type RecordPaymentResult = {
+    signature: string;
+};
+declare function recordPayment(args: RecordPaymentArgs): Promise<RecordPaymentResult>;
+
+type SubscribeOptions = {
+    onFrame: (frame: LiveEventFrame) => void;
+    onStatus?: (status: LiveStatus) => void;
+};
+declare function subscribeService(apiBase: string, servicePubkey: string, opts: SubscribeOptions): Subscription;
+declare function subscribeVault(apiBase: string, vaultPubkey: string, opts: SubscribeOptions): Subscription;
 
 type PaymentRequirement = {
     recipient: string;
@@ -190,4 +241,4 @@ declare class PaymentParseError extends AgentFuelError {
 }
 declare function paymentRequired(fuel: AgentFuel, opts?: PaymentRequiredOptions): FetchLike;
 
-export { ASSOCIATED_TOKEN_PROGRAM_ID, AccountNotFoundError, AgentFuel, AgentFuelError, type AgentFuelOptions, type Cluster, type CreditVaultAccount, type FetchLike, HourlyLimitExceededError, HttpError, LifetimeLimitExceededError, type LiveEventFrame, type LiveStatus, NotWhitelistedError, type OnEventOptions, OwnerNotConfiguredError, PROGRAM_IDS, PaymentParseError, type PaymentRequiredOptions, type PaymentRequirement, PerTxLimitExceededError, type Pubkeyish, type ReputationLookup, SLOTS_PER_HOUR, type ServiceCategory, type ServiceRegistryAccount, type SpendArgs, type SpendPolicyAccount, SpendPolicyError, type SpendResult, type Subscription, TOKEN_PROGRAM_ID, VaultFrozenError, type VaultRef, ZeroAmountError, createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddress, paymentRequired, policyPda, serviceRegistryPda, vaultPda };
+export { ASSOCIATED_TOKEN_PROGRAM_ID, AccountNotFoundError, AgentFuel, AgentFuelError, type AgentFuelOptions, type Cluster, type CreditVaultAccount, type FetchLike, HourlyLimitExceededError, HttpError, LifetimeLimitExceededError, type LiveEventFrame, type LiveStatus, NotWhitelistedError, type OnEventOptions, OwnerNotConfiguredError, PROGRAM_IDS, PaymentParseError, type PaymentRequiredOptions, type PaymentRequirement, PerTxLimitExceededError, type Pubkeyish, ReceiptAlreadyRecordedError, type RecordPaymentArgs, RecordPaymentError, type RecordPaymentResult, type ReputationLookup, SLOTS_PER_HOUR, type ServiceCategory, ServiceInactiveError, type ServiceRegistryAccount, type SpendArgs, type SpendPolicyAccount, SpendPolicyError, type SpendResult, type SubscribeOptions, type Subscription, TOKEN_PROGRAM_ID, VaultFrozenError, type VaultRef, ZeroAmountError, agentProfilePda, agentServiceLinkPda, createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddress, paymentRequired, policyPda, receiptUsedPda, recordPayment, serviceRegistryPda, subscribeService, subscribeVault, vaultPda };

package/dist/index.js

@@ -185,6 +185,28 @@ var NotWhitelistedError = class extends SpendPolicyError {
     this.service = service;
   }
 };
+var RecordPaymentError = class extends AgentFuelError {
+  constructor(message) {
+    super(message);
+    this.name = "RecordPaymentError";
+  }
+};
+var ReceiptAlreadyRecordedError = class extends RecordPaymentError {
+  receiptHash;
+  constructor(receiptHash) {
+    super("payment receipt was already recorded on chain");
+    this.name = "ReceiptAlreadyRecordedError";
+    this.receiptHash = receiptHash;
+  }
+};
+var ServiceInactiveError = class extends RecordPaymentError {
+  service;
+  constructor(service) {
+    super(`service ${service} is paused; record_payment rejected`);
+    this.name = "ServiceInactiveError";
+    this.service = service;
+  }
+};
 
 // src/guardrails.ts
 function guardSpend(args) {
@@ -292,6 +314,12 @@ function wsUrl(apiBase, path) {
   if (apiBase.startsWith("http://")) return apiBase.replace(/^http/, "ws") + path;
   return apiBase + path;
 }
+function subscribeService(apiBase, servicePubkey, opts) {
+  return subscribe(wsUrl(apiBase, `/ws/services/${servicePubkey}`), opts);
+}
+function subscribeVault(apiBase, vaultPubkey, opts) {
+  return subscribe(wsUrl(apiBase, `/ws/vaults/${vaultPubkey}`), opts);
+}
 
 // src/idl/reputation.json
 var reputation_default = {
@@ -847,10 +875,14 @@ var reputation_default = {
       ],
       accounts: [
         {
-          name: "service",
+          name: "sponsor",
           writable: true,
           signer: true
         },
+        {
+          name: "service",
+          signer: true
+        },
         {
           name: "service_registry",
           writable: true,
@@ -897,6 +929,15 @@ var reputation_default = {
               name: "ServiceCategory"
             }
           }
+        },
+        {
+          name: "service_uri",
+          type: {
+            array: [
+              "u8",
+              128
+            ]
+          }
         }
       ]
     },
@@ -1012,6 +1053,61 @@ var reputation_default = {
           }
         }
       ]
+    },
+    {
+      name: "set_service_active",
+      discriminator: [
+        221,
+        172,
+        149,
+        49,
+        212,
+        184,
+        77,
+        101
+      ],
+      accounts: [
+        {
+          name: "service",
+          signer: true
+        },
+        {
+          name: "service_registry",
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  115,
+                  101,
+                  114,
+                  118,
+                  105,
+                  99,
+                  101
+                ]
+              },
+              {
+                kind: "account",
+                path: "service"
+              }
+            ]
+          }
+        },
+        {
+          name: "authority",
+          relations: [
+            "service_registry"
+          ]
+        }
+      ],
+      args: [
+        {
+          name: "active",
+          type: "bool"
+        }
+      ]
     }
   ],
   accounts: [
@@ -1160,6 +1256,19 @@ var reputation_default = {
         109
       ]
     },
+    {
+      name: "ServiceActiveSet",
+      discriminator: [
+        151,
+        122,
+        7,
+        40,
+        191,
+        139,
+        237,
+        52
+      ]
+    },
     {
       name: "ServiceRegistered",
       discriminator: [
@@ -1224,6 +1333,11 @@ var reputation_default = {
       code: 6009,
       name: "FeedbackRateLimited",
       msg: "Feedback rate limit not yet expired for this (service, agent) pair"
+    },
+    {
+      code: 6010,
+      name: "UnauthorizedService",
+      msg: "Only the service authority may perform this action"
     }
   ],
   types: [
@@ -1664,6 +1778,26 @@ var reputation_default = {
         ]
       }
     },
+    {
+      name: "ServiceActiveSet",
+      type: {
+        kind: "struct",
+        fields: [
+          {
+            name: "service",
+            type: "pubkey"
+          },
+          {
+            name: "active",
+            type: "bool"
+          },
+          {
+            name: "slot",
+            type: "u64"
+          }
+        ]
+      }
+    },
     {
       name: "ServiceCategory",
       type: {
@@ -1696,6 +1830,14 @@ var reputation_default = {
             name: "service",
             type: "pubkey"
           },
+          {
+            name: "sponsor",
+            docs: [
+              'Wallet that paid rent. Lets us answer "who registered this service?"',
+              "without an extra column on the on-chain account."
+            ],
+            type: "pubkey"
+          },
           {
             name: "name",
             type: {
@@ -1738,6 +1880,19 @@ var reputation_default = {
               ]
             }
           },
+          {
+            name: "service_uri",
+            docs: [
+              "Off-chain metadata URI (pricing, docs, endpoint, logo). Padded to 128 bytes;",
+              "trailing NULs are trimmed when read. Mirrors `AgentProfile::agent_uri`."
+            ],
+            type: {
+              array: [
+                "u8",
+                128
+              ]
+            }
+          },
           {
             name: "category",
             type: {
@@ -3094,6 +3249,34 @@ function serviceRegistryPda(serviceAuthority) {
   );
   return pda;
 }
+function agentProfilePda(agent) {
+  const [pda] = PublicKey.findProgramAddressSync(
+    [Buffer.from("agent"), toPubkey(agent).toBuffer()],
+    PROGRAM_IDS.reputation
+  );
+  return pda;
+}
+function agentServiceLinkPda(agentProfile, serviceRegistry) {
+  const [pda] = PublicKey.findProgramAddressSync(
+    [
+      Buffer.from("link"),
+      toPubkey(agentProfile).toBuffer(),
+      toPubkey(serviceRegistry).toBuffer()
+    ],
+    PROGRAM_IDS.reputation
+  );
+  return pda;
+}
+function receiptUsedPda(receiptHash) {
+  if (receiptHash.length !== 32) {
+    throw new Error(`receiptUsedPda expects a 32-byte hash, got ${receiptHash.length}`);
+  }
+  const [pda] = PublicKey.findProgramAddressSync(
+    [Buffer.from("receipt"), Buffer.from(receiptHash)],
+    PROGRAM_IDS.reputation
+  );
+  return pda;
+}
 function buildProvider(connection, keypair) {
   return new AnchorProvider(connection, new Wallet(keypair), AnchorProvider.defaultOptions());
 }
@@ -3202,6 +3385,21 @@ var AgentFuel = class {
       throw mapSpendError(err, { service, amountUsdc, vault, policy });
     }
   }
+  /// Triggers an on-chain recomputation of the agent's reputation score.
+  /// Permissionless — any signer can call it; we use the agent itself since
+  /// the SDK already has its keypair available and it already pays tx fees
+  /// for spends. The instruction reads the agent's already-public counters
+  /// (volume, diversity, streak, tenure, feedback), recalculates the score
+  /// to a single u16 ≤ 1000, and emits a `ScoreComputed` event. The webhook
+  /// picks that up; the next `getScore()` returns the fresh value.
+  async computeScore() {
+    const profile = agentProfilePda(this.agentPubkey);
+    const signature = await this.reputation.methods.computeScore().accounts({
+      caller: this.agentPubkey,
+      agentProfile: profile
+    }).signers([this.agent]).rpc();
+    return { signature };
+  }
   onEvent(callback, options) {
     const target = options?.agent ? toPubkey(options.agent) : this.agentPubkey;
     const url = wsUrl(this.apiBase, `/ws/agents/${target.toBase58()}`);
@@ -3246,6 +3444,56 @@ async function safeText(res) {
     return void 0;
   }
 }
+async function recordPayment(args) {
+  const { service, connection, amountUsdc } = args;
+  const agentPubkey = toPubkey(args.agent);
+  if (amountUsdc <= 0) {
+    throw new Error("recordPayment: amountUsdc must be > 0");
+  }
+  if (args.receiptHash.length !== 32) {
+    throw new Error(
+      `recordPayment: receiptHash must be 32 bytes, got ${args.receiptHash.length}`
+    );
+  }
+  const provider = buildProvider(connection, service);
+  const program = reputationProgram(provider);
+  const agentProfile = agentProfilePda(agentPubkey);
+  const serviceRegistry = serviceRegistryPda(service.publicKey);
+  const link = agentServiceLinkPda(agentProfile, serviceRegistry);
+  const receipt = receiptUsedPda(args.receiptHash);
+  try {
+    const signature = await program.methods.recordPayment(new BN(amountUsdc), args.receiptHash).accounts({
+      service: service.publicKey,
+      agentProfile,
+      serviceRegistry,
+      agentServiceLink: link,
+      receiptUsed: receipt,
+      systemProgram: SystemProgram.programId
+    }).signers([service]).rpc();
+    return { signature };
+  } catch (err) {
+    throw mapRecordPaymentError(err, args.receiptHash);
+  }
+}
+function mapRecordPaymentError(err, receiptHash) {
+  const message = err instanceof Error ? err.message : String(err);
+  if (/already in use/i.test(message)) {
+    return new ReceiptAlreadyRecordedError(receiptHash);
+  }
+  if (!(err instanceof AnchorError)) return err;
+  switch (err.error.errorCode.number) {
+    case 6e3:
+      return new RecordPaymentError("counter overflow on chain");
+    case 6001:
+      return new ServiceInactiveError(
+        err.error.origin?.toString() ?? "<unknown service>"
+      );
+    case 6002:
+      return new ZeroAmountError();
+    default:
+      return err;
+  }
+}
 
 // src/x402.ts
 var HEADER = "X-Payment-Required";
@@ -3332,6 +3580,6 @@ function truncate(s) {
   return s.length > 80 ? `${s.slice(0, 80)}\u2026` : s;
 }
 
-export { ASSOCIATED_TOKEN_PROGRAM_ID, AccountNotFoundError, AgentFuel, AgentFuelError, HourlyLimitExceededError, HttpError, LifetimeLimitExceededError, NotWhitelistedError, OwnerNotConfiguredError, PROGRAM_IDS, PaymentParseError, PerTxLimitExceededError, SLOTS_PER_HOUR, SpendPolicyError, TOKEN_PROGRAM_ID, VaultFrozenError, ZeroAmountError, createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddress, paymentRequired, policyPda, serviceRegistryPda, vaultPda };
+export { ASSOCIATED_TOKEN_PROGRAM_ID, AccountNotFoundError, AgentFuel, AgentFuelError, HourlyLimitExceededError, HttpError, LifetimeLimitExceededError, NotWhitelistedError, OwnerNotConfiguredError, PROGRAM_IDS, PaymentParseError, PerTxLimitExceededError, ReceiptAlreadyRecordedError, RecordPaymentError, SLOTS_PER_HOUR, ServiceInactiveError, SpendPolicyError, TOKEN_PROGRAM_ID, VaultFrozenError, ZeroAmountError, agentProfilePda, agentServiceLinkPda, createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddress, paymentRequired, policyPda, receiptUsedPda, recordPayment, serviceRegistryPda, subscribeService, subscribeVault, vaultPda };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map