@elisym/sdk 0.12.0 → 0.12.2

package/dist/index.d.cts

@@ -205,10 +205,10 @@ type Signer = TransactionSigner;
 /**
  * Protocol fee + treasury inputs for building a payment request.
  *
- * In Phase 2 the SDK no longer reads PROTOCOL_FEE_BPS / PROTOCOL_TREASURY
- * from constants. Callers supply this config so they can either pass
- * the bundled fallbacks or, in Phase 3, values fetched from the on-chain
- * elisym-config program.
+ * Callers must supply this config explicitly - the SDK does not bundle a
+ * fallback. The canonical source is `getProtocolConfig(rpc, programId)`,
+ * which reads the on-chain elisym-config program; tests and offline tools
+ * may pass fixture values directly.
  */
 interface ProtocolConfigInput {
     /** Protocol fee in basis points (300 = 3%). Must be a non-negative integer. */
@@ -404,6 +404,16 @@ declare class DiscoveryService {
      * provider.
      */
     fetchAgents(network?: Network, limit?: number): Promise<Agent[]>;
+    /**
+     * Fetch a single agent by pubkey, fully enriched (kind:0 metadata,
+     * cross-checked `lastPaidJobAt`, rating counters). Returns `null` if the
+     * pubkey has no surviving capability cards on the requested network.
+     *
+     * Use this when navigating directly to an agent's page; running
+     * `fetchAgents`/`streamAgents` for that case streams the entire marketplace
+     * just to find one author.
+     */
+    fetchAgent(network: Network, pubkey: string): Promise<Agent | null>;
     /**
      * Enrich an agent map with paid-job stats, feedback counters, and kind:0
      * metadata, then return them sorted by `compareAgentsByRank`. Mutates the
@@ -671,9 +681,8 @@ declare function assertLamports(value: number, field: string): void;
  * Calculate the protocol fee using basis-point math (no floats).
  * Returns ceil(amount * feeBps / 10000).
  *
- * The caller passes the current fee (in basis points). Phase 2 of the
- * Solana Kit migration removes the implicit dependency on PROTOCOL_FEE_BPS
- * so callers can supply on-chain or test values.
+ * The caller passes the current fee (in basis points), typically obtained
+ * from `getProtocolConfig` or supplied as a test fixture.
  */
 declare function calculateProtocolFee(amount: number, feeBps: number): number;
 /** Validate payment request timestamps. Returns error message or null if valid. */
@@ -1082,21 +1091,6 @@ declare function jobResultKind(offset: number): number;
 declare const KIND_PING = 20200;
 declare const KIND_PONG = 20201;
 declare const LAMPORTS_PER_SOL = 1000000000;
-/**
- * @deprecated Fallback only - use `getProtocolConfig(rpc, programId)` for live values.
- *
- * Protocol fee in basis points (300 = 3%). Bundled as a default for offline use
- * and for first-call before the on-chain config has been fetched. The on-chain
- * `elisym-config` program is the source of truth.
- */
-declare const PROTOCOL_FEE_BPS = 300;
-/**
- * @deprecated Fallback only - use `getProtocolConfig(rpc, programId)` for live values.
- *
- * Solana address of the protocol treasury. Bundled fallback; the on-chain
- * `elisym-config` program is the source of truth and may rotate this address.
- */
-declare const PROTOCOL_TREASURY: Address;
 /**
  * Solana program ID for the elisym protocol config (devnet deployment).
  *
@@ -1151,4 +1145,4 @@ declare const LIMITS: {
     readonly MAX_CAPABILITY_LENGTH: 64;
 };
 
-export { type Agent, type AggregateNetworkStatsOptions, Asset, BoundedSet, type BuildTransactionOptions, type CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DEFAULT_REDACT_PATHS, DiscoveryService, ELISYM_PROTOCOL_TAG, ElisymClient, type ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, type EstimatePriorityFeeOptions, type EstimateSolFeeOptions, type GetProtocolConfigOptions, INPUT_REDACT_PATHS, type Job, type JobStatus, type JobSubscriptionOptions, type JobUpdateCallbacks, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, type Network, type NetworkStats, type NetworkStatsResult, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_PROGRAM_ID_DEVNET, PROTOCOL_TREASURY, type ParseOptions, type ParseResult, type ParsedPaymentRequest, type PaymentAssetRef, type PaymentInfo, type PaymentRequestData, PaymentRequestSchema, type PaymentStrategy, type PaymentValidationCode, type PaymentValidationError, type PingResult, PingService, type ProtocolCluster, type ProtocolConfig, type ProtocolConfigInput, type QuickVerifyReason, type QuickVerifyResult, RELAYS, type RankKey, type RateLimitDecision, SECRET_REDACT_PATHS, type Signer, type SlidingWindowLimiter, type SlidingWindowLimiterOptions, type SolFeeEstimate, SolanaPaymentStrategy, type SubCloser, type SubmitJobOptions, type VerifyOptions, type VerifyResult, aggregateNetworkStats, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearPriorityFeeCache, clearProtocolConfigCache, clearQuickVerifyCache, compareAgentsByRank, computeRankKey, createPaymentRequestWithOnchainConfig, createSlidingWindowLimiter, estimatePriorityFeeMicroLamports, estimateSolFeeLamports, formatFeeBreakdown, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, makeCensor, nip44Decrypt, nip44Encrypt, parsePaymentRequest, pickPercentileFee, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry, verifyJobPaymentQuick };
+export { type Agent, type AggregateNetworkStatsOptions, Asset, BoundedSet, type BuildTransactionOptions, type CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DEFAULT_REDACT_PATHS, DiscoveryService, ELISYM_PROTOCOL_TAG, ElisymClient, type ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, type EstimatePriorityFeeOptions, type EstimateSolFeeOptions, type GetProtocolConfigOptions, INPUT_REDACT_PATHS, type Job, type JobStatus, type JobSubscriptionOptions, type JobUpdateCallbacks, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, type Network, type NetworkStats, type NetworkStatsResult, NostrPool, PROTOCOL_PROGRAM_ID_DEVNET, type ParseOptions, type ParseResult, type ParsedPaymentRequest, type PaymentAssetRef, type PaymentInfo, type PaymentRequestData, PaymentRequestSchema, type PaymentStrategy, type PaymentValidationCode, type PaymentValidationError, type PingResult, PingService, type ProtocolCluster, type ProtocolConfig, type ProtocolConfigInput, type QuickVerifyReason, type QuickVerifyResult, RELAYS, type RankKey, type RateLimitDecision, SECRET_REDACT_PATHS, type Signer, type SlidingWindowLimiter, type SlidingWindowLimiterOptions, type SolFeeEstimate, SolanaPaymentStrategy, type SubCloser, type SubmitJobOptions, type VerifyOptions, type VerifyResult, aggregateNetworkStats, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearPriorityFeeCache, clearProtocolConfigCache, clearQuickVerifyCache, compareAgentsByRank, computeRankKey, createPaymentRequestWithOnchainConfig, createSlidingWindowLimiter, estimatePriorityFeeMicroLamports, estimateSolFeeLamports, formatFeeBreakdown, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, makeCensor, nip44Decrypt, nip44Encrypt, parsePaymentRequest, pickPercentileFee, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry, verifyJobPaymentQuick };

package/dist/index.d.ts

@@ -205,10 +205,10 @@ type Signer = TransactionSigner;
 /**
  * Protocol fee + treasury inputs for building a payment request.
  *
- * In Phase 2 the SDK no longer reads PROTOCOL_FEE_BPS / PROTOCOL_TREASURY
- * from constants. Callers supply this config so they can either pass
- * the bundled fallbacks or, in Phase 3, values fetched from the on-chain
- * elisym-config program.
+ * Callers must supply this config explicitly - the SDK does not bundle a
+ * fallback. The canonical source is `getProtocolConfig(rpc, programId)`,
+ * which reads the on-chain elisym-config program; tests and offline tools
+ * may pass fixture values directly.
  */
 interface ProtocolConfigInput {
     /** Protocol fee in basis points (300 = 3%). Must be a non-negative integer. */
@@ -404,6 +404,16 @@ declare class DiscoveryService {
      * provider.
      */
     fetchAgents(network?: Network, limit?: number): Promise<Agent[]>;
+    /**
+     * Fetch a single agent by pubkey, fully enriched (kind:0 metadata,
+     * cross-checked `lastPaidJobAt`, rating counters). Returns `null` if the
+     * pubkey has no surviving capability cards on the requested network.
+     *
+     * Use this when navigating directly to an agent's page; running
+     * `fetchAgents`/`streamAgents` for that case streams the entire marketplace
+     * just to find one author.
+     */
+    fetchAgent(network: Network, pubkey: string): Promise<Agent | null>;
     /**
      * Enrich an agent map with paid-job stats, feedback counters, and kind:0
      * metadata, then return them sorted by `compareAgentsByRank`. Mutates the
@@ -671,9 +681,8 @@ declare function assertLamports(value: number, field: string): void;
  * Calculate the protocol fee using basis-point math (no floats).
  * Returns ceil(amount * feeBps / 10000).
  *
- * The caller passes the current fee (in basis points). Phase 2 of the
- * Solana Kit migration removes the implicit dependency on PROTOCOL_FEE_BPS
- * so callers can supply on-chain or test values.
+ * The caller passes the current fee (in basis points), typically obtained
+ * from `getProtocolConfig` or supplied as a test fixture.
  */
 declare function calculateProtocolFee(amount: number, feeBps: number): number;
 /** Validate payment request timestamps. Returns error message or null if valid. */
@@ -1082,21 +1091,6 @@ declare function jobResultKind(offset: number): number;
 declare const KIND_PING = 20200;
 declare const KIND_PONG = 20201;
 declare const LAMPORTS_PER_SOL = 1000000000;
-/**
- * @deprecated Fallback only - use `getProtocolConfig(rpc, programId)` for live values.
- *
- * Protocol fee in basis points (300 = 3%). Bundled as a default for offline use
- * and for first-call before the on-chain config has been fetched. The on-chain
- * `elisym-config` program is the source of truth.
- */
-declare const PROTOCOL_FEE_BPS = 300;
-/**
- * @deprecated Fallback only - use `getProtocolConfig(rpc, programId)` for live values.
- *
- * Solana address of the protocol treasury. Bundled fallback; the on-chain
- * `elisym-config` program is the source of truth and may rotate this address.
- */
-declare const PROTOCOL_TREASURY: Address;
 /**
  * Solana program ID for the elisym protocol config (devnet deployment).
  *
@@ -1151,4 +1145,4 @@ declare const LIMITS: {
     readonly MAX_CAPABILITY_LENGTH: 64;
 };
 
-export { type Agent, type AggregateNetworkStatsOptions, Asset, BoundedSet, type BuildTransactionOptions, type CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DEFAULT_REDACT_PATHS, DiscoveryService, ELISYM_PROTOCOL_TAG, ElisymClient, type ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, type EstimatePriorityFeeOptions, type EstimateSolFeeOptions, type GetProtocolConfigOptions, INPUT_REDACT_PATHS, type Job, type JobStatus, type JobSubscriptionOptions, type JobUpdateCallbacks, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, type Network, type NetworkStats, type NetworkStatsResult, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_PROGRAM_ID_DEVNET, PROTOCOL_TREASURY, type ParseOptions, type ParseResult, type ParsedPaymentRequest, type PaymentAssetRef, type PaymentInfo, type PaymentRequestData, PaymentRequestSchema, type PaymentStrategy, type PaymentValidationCode, type PaymentValidationError, type PingResult, PingService, type ProtocolCluster, type ProtocolConfig, type ProtocolConfigInput, type QuickVerifyReason, type QuickVerifyResult, RELAYS, type RankKey, type RateLimitDecision, SECRET_REDACT_PATHS, type Signer, type SlidingWindowLimiter, type SlidingWindowLimiterOptions, type SolFeeEstimate, SolanaPaymentStrategy, type SubCloser, type SubmitJobOptions, type VerifyOptions, type VerifyResult, aggregateNetworkStats, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearPriorityFeeCache, clearProtocolConfigCache, clearQuickVerifyCache, compareAgentsByRank, computeRankKey, createPaymentRequestWithOnchainConfig, createSlidingWindowLimiter, estimatePriorityFeeMicroLamports, estimateSolFeeLamports, formatFeeBreakdown, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, makeCensor, nip44Decrypt, nip44Encrypt, parsePaymentRequest, pickPercentileFee, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry, verifyJobPaymentQuick };
+export { type Agent, type AggregateNetworkStatsOptions, Asset, BoundedSet, type BuildTransactionOptions, type CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DEFAULT_REDACT_PATHS, DiscoveryService, ELISYM_PROTOCOL_TAG, ElisymClient, type ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, type EstimatePriorityFeeOptions, type EstimateSolFeeOptions, type GetProtocolConfigOptions, INPUT_REDACT_PATHS, type Job, type JobStatus, type JobSubscriptionOptions, type JobUpdateCallbacks, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, type Network, type NetworkStats, type NetworkStatsResult, NostrPool, PROTOCOL_PROGRAM_ID_DEVNET, type ParseOptions, type ParseResult, type ParsedPaymentRequest, type PaymentAssetRef, type PaymentInfo, type PaymentRequestData, PaymentRequestSchema, type PaymentStrategy, type PaymentValidationCode, type PaymentValidationError, type PingResult, PingService, type ProtocolCluster, type ProtocolConfig, type ProtocolConfigInput, type QuickVerifyReason, type QuickVerifyResult, RELAYS, type RankKey, type RateLimitDecision, SECRET_REDACT_PATHS, type Signer, type SlidingWindowLimiter, type SlidingWindowLimiterOptions, type SolFeeEstimate, SolanaPaymentStrategy, type SubCloser, type SubmitJobOptions, type VerifyOptions, type VerifyResult, aggregateNetworkStats, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearPriorityFeeCache, clearProtocolConfigCache, clearQuickVerifyCache, compareAgentsByRank, computeRankKey, createPaymentRequestWithOnchainConfig, createSlidingWindowLimiter, estimatePriorityFeeMicroLamports, estimateSolFeeLamports, formatFeeBreakdown, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, makeCensor, nip44Decrypt, nip44Encrypt, parsePaymentRequest, pickPercentileFee, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry, verifyJobPaymentQuick };

package/dist/index.js

@@ -37,8 +37,6 @@ function jobResultKind(offset) {
 var KIND_PING = 20200;
 var KIND_PONG = 20201;
 var LAMPORTS_PER_SOL = 1e9;
-var PROTOCOL_FEE_BPS = 300;
-var PROTOCOL_TREASURY = "GY7vnWMkKpftU4nQ16C2ATkj1JwrQpHhknkaBUn67VTy";
 var PROTOCOL_PROGRAM_ID_DEVNET = "BrX1CRkSgvcjxBvc2bgc3QqgWjinusofDmeP7ZVxvwrE";
 var ELISYM_PROTOCOL_TAG = "ELiZksgwDt41LaeuPDLkUfWgFXhGgVayTMP7L5nTSEL8";
 function getProtocolProgramId(cluster) {
@@ -1263,6 +1261,29 @@ var DiscoveryService = class {
     const agents = Array.from(agentMap.values());
     return this.runEnrichment(agents, agentMap, NEVER_ABORTED_SIGNAL);
   }
+  /**
+   * Fetch a single agent by pubkey, fully enriched (kind:0 metadata,
+   * cross-checked `lastPaidJobAt`, rating counters). Returns `null` if the
+   * pubkey has no surviving capability cards on the requested network.
+   *
+   * Use this when navigating directly to an agent's page; running
+   * `fetchAgents`/`streamAgents` for that case streams the entire marketplace
+   * just to find one author.
+   */
+  async fetchAgent(network, pubkey) {
+    const events = await this.pool.querySync({
+      kinds: [KIND_APP_HANDLER],
+      "#t": ["elisym"],
+      authors: [pubkey]
+    });
+    const agentMap = buildAgentsFromEvents(events, network);
+    if (agentMap.size === 0) {
+      return null;
+    }
+    const agents = Array.from(agentMap.values());
+    await this.runEnrichment(agents, agentMap, NEVER_ABORTED_SIGNAL);
+    return agentMap.get(pubkey) ?? null;
+  }
   /**
    * Enrich an agent map with paid-job stats, feedback counters, and kind:0
    * metadata, then return them sorted by `compareAgentsByRank`. Mutates the
@@ -3341,6 +3362,6 @@ function makeCensor() {
   };
 }
 
-export { BoundedSet, DEFAULTS, DEFAULT_KIND_OFFSET, DEFAULT_REDACT_PATHS, DiscoveryService, ELISYM_PROTOCOL_TAG, ElisymClient, ElisymIdentity, GlobalConfigSchema, INPUT_REDACT_PATHS, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, KNOWN_ASSETS, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, NATIVE_SOL, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_PROGRAM_ID_DEVNET, PROTOCOL_TREASURY, PaymentRequestSchema, PingService, RELAYS, SECRET_REDACT_PATHS, SessionSpendLimitEntrySchema, SolanaPaymentStrategy, USDC_SOLANA_DEVNET, aggregateNetworkStats, assertExpiry, assertLamports, assetByKey, assetKey, buildPaymentInstructions, calculateProtocolFee, clearPriorityFeeCache, clearProtocolConfigCache, clearQuickVerifyCache, compareAgentsByRank, computeRankKey, createPaymentRequestWithOnchainConfig, createSlidingWindowLimiter, estimatePriorityFeeMicroLamports, estimateSolFeeLamports, formatAssetAmount, formatFeeBreakdown, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, makeCensor, nip44Decrypt, nip44Encrypt, parseAssetAmount, parsePaymentRequest, pickPercentileFee, resolveAssetFromPaymentRequest, resolveKnownAsset, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry, verifyJobPaymentQuick };
+export { BoundedSet, DEFAULTS, DEFAULT_KIND_OFFSET, DEFAULT_REDACT_PATHS, DiscoveryService, ELISYM_PROTOCOL_TAG, ElisymClient, ElisymIdentity, GlobalConfigSchema, INPUT_REDACT_PATHS, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, KNOWN_ASSETS, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, NATIVE_SOL, NostrPool, PROTOCOL_PROGRAM_ID_DEVNET, PaymentRequestSchema, PingService, RELAYS, SECRET_REDACT_PATHS, SessionSpendLimitEntrySchema, SolanaPaymentStrategy, USDC_SOLANA_DEVNET, aggregateNetworkStats, assertExpiry, assertLamports, assetByKey, assetKey, buildPaymentInstructions, calculateProtocolFee, clearPriorityFeeCache, clearProtocolConfigCache, clearQuickVerifyCache, compareAgentsByRank, computeRankKey, createPaymentRequestWithOnchainConfig, createSlidingWindowLimiter, estimatePriorityFeeMicroLamports, estimateSolFeeLamports, formatAssetAmount, formatFeeBreakdown, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, makeCensor, nip44Decrypt, nip44Encrypt, parseAssetAmount, parsePaymentRequest, pickPercentileFee, resolveAssetFromPaymentRequest, resolveKnownAsset, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry, verifyJobPaymentQuick };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map