@piprail/sdk 2.0.2 → 2.1.0

package/dist/index.d.cts

@@ -4489,8 +4489,24 @@ interface DiscoveredResource {
     name?: string;
     description?: string;
     category?: string;
+    /** Free-text tags/keywords, when the index reports them. */
+    tags?: string[];
     /** Advertised price in USD, when the index reports one (402 Index). */
     priceUsd?: number;
+    /** Health/uptime score 0–100, when the index reports one (402 Index `reliability_score`).
+     *  Higher = a more reliable, consistently-probeable endpoint — sort/filter on it to
+     *  skip flaky resources. Absent for indexes that don't measure it (Bazaar). */
+    reliabilityScore?: number;
+    /** Liveness as the index last probed it, e.g. `'healthy'` / `'degraded'` / `'down'`
+     *  (402 Index `health_status`). Absent where unmeasured. */
+    health?: string;
+    /** Whether the listing's domain is verified at the index (402 Index `domain_verified`).
+     *  A verified resource is a stronger trust + relevance signal. Absent where the index
+     *  has no such concept (Bazaar). */
+    verified?: boolean;
+    /** Relevance score for the active query (set by {@link rankResources}); higher ranks
+     *  first. Absent when no query was given (results keep first-seen / sort order). */
+    score?: number;
     /** The payment options the index advertises (best-effort, cross-scheme). */
     rails: DiscoveredRail[];
 }
@@ -4521,13 +4537,46 @@ interface RegisterOutcome {
      *  x402scan, so a live listing there won't appear in discover() results". */
     note?: string;
 }
+/** How to order results. `'relevance'` (the default when a {@link SearchOpenIndexesOptions.query}
+ *  is given) ranks by query match via {@link rankResources}; the rest sort by a single field
+ *  (descending unless `order:'asc'`), using each index's reported value (unknowns sort last). */
+type DiscoverySort = 'relevance' | 'reliability' | 'price' | 'uptime' | 'latency' | 'name';
 interface SearchOpenIndexesOptions {
-    /** Free-text query (filtered client-side against name/description/resource). */
+    /**
+     * Free-text query. Tokenized and matched across name / description / category / URL:
+     * 402 Index is searched server-side (one request per token, unioned — so a multi-word
+     * query like `"piprail demo"` still finds a resource that matches each word, which the
+     * index's own AND-tokenized `?q=` would miss), the Bazaar list is filtered client-side,
+     * and the merged set is ranked by relevance ({@link rankResources}).
+     */
     query?: string;
     /** Which indexes to read. Default `['bazaar', '402index']` (both free). */
     sources?: DiscoverySource[];
-    /** Max results per source before dedupe. Default 20. */
+    /** Max results to FETCH per index request. Default 20. */
     limit?: number;
+    /** Keep ONLY this category (prefix match, case-insensitive) — strict: a resource the
+     *  index didn't categorize is dropped (pushed to 402 Index server-side too). */
+    category?: string;
+    /** Keep only resources paying in this asset symbol, e.g. `'USDC'` (pushed to 402 Index;
+     *  applied client-side elsewhere, keeping items whose asset the index didn't report). */
+    asset?: string;
+    /** Drop results advertised above this USD price (results with no advertised price pass). */
+    maxPrice?: number;
+    /** Drop results whose reliability score is BELOW this (0–100). Results with no reported
+     *  score pass through — use {@link DiscoveredResource.reliabilityScore} to inspect. */
+    minReliability?: number;
+    /** Prefer verified listings (402 Index `verified=true`, server-side). NOTE: 402 Index's
+     *  `verified` flag and its per-record `domain_verified` differ, so this is applied at the
+     *  index, not re-filtered client-side; sources without a verified concept pass through.
+     *  Inspect {@link DiscoveredResource.verified} for the per-record ownership signal. */
+    verified?: boolean;
+    /** Restrict to listings the index confirmed are payable x402 (402 Index `payment_valid=true`). */
+    paymentValid?: boolean;
+    /** Result ordering — see {@link DiscoverySort}. Default `'relevance'` with a query, else
+     *  first-seen order (source priority). */
+    sort?: DiscoverySort;
+    /** Sort direction for a non-relevance {@link sort}. Default `'desc'`. */
+    order?: 'asc' | 'desc';
     signal?: AbortSignal;
 }
 /** What a merchant submits to register one resource on the open indexes. */
@@ -4542,6 +4591,28 @@ interface RegisterInput {
     network?: string;
     /** HTTP method the resource answers on. Default 'GET'. */
     method?: string;
+    /**
+     * A category for the listing, e.g. `'ai'`, `'finance'`, `'data'`. The single
+     * highest-leverage field for findability: most of 402 Index's catalog is
+     * `uncategorized`, so a real category makes a resource rank + filter where almost
+     * nothing else does. Free-text; pick the obvious bucket for what the endpoint does.
+     */
+    category?: string;
+    /**
+     * Keywords for the listing. 402 Index search is literal (a term must appear in the
+     * name or description to match), so these are folded into the description as a compact
+     * keyword tail — making the resource findable by each term — and also sent as a `tags`
+     * field for any index that indexes them natively. Skipped if already present / over the
+     * length cap (same tasteful rules as the attribution suffix).
+     */
+    tags?: string[];
+    /** Who runs the resource (provider/org name) — 402 Index `provider` metadata. */
+    provider?: string;
+    /** Contact email for the listing (402 Index `contact_email`) — also used by domain claim. */
+    contactEmail?: string;
+    /** A JSON request body 402 Index should send when health-checking a POST/PUT resource
+     *  (402 Index `probe_body`), so probes succeed and the reliability score stays high. */
+    probeBody?: unknown;
     /**
      * Attribute the listing to PipRail. **Default ON** (set `false` to opt out). When on, the
      * payload gets a `via: '@piprail/sdk'` provenance field AND a compact `· Built with
@@ -4602,11 +4673,28 @@ declare function decorateOutcome(o: RegisterOutcome): RegisterOutcome;
  *  "unresolved — don't hide it" rather than a confident mismatch. */
 declare function normalizeNetwork(network: string): string;
 /**
- * Search the open indexes for payable resources, in parallel, and merge them
- * (deduped by resource URL — the first source in `sources` wins). NEVER throws:
- * any index that errors, times out, or changes shape contributes `[]`.
+ * Search the open indexes for payable resources, in parallel, and merge them into
+ * one ranked list (deduped by resource URL — the first source in `sources` wins).
+ * NEVER throws: any index that errors, times out, or changes shape contributes `[]`.
+ *
+ * Pipeline: fetch (402 Index server-side, with a per-token fan-out for multi-word
+ * queries + server-side filters; Bazaar list, filtered client-side) → merge + dedupe
+ * → client-side filters ({@link SearchOpenIndexesOptions.maxPrice}/`category`/`asset`/
+ * `minReliability`, all keeping items the index didn't annotate) → rank/sort.
  */
 declare function searchOpenIndexes(opts?: SearchOpenIndexesOptions): Promise<DiscoveredResource[]>;
+/** Relevance score of one resource for a tokenized query. Exact token hits score full
+ *  weight; a substring/prefix hit scores a fraction (only for tokens ≥4 chars, so short
+ *  words like "ai"/"for" don't fuzz-match noise). A resource matching EVERY query token
+ *  gets a big "complete match" bonus (this is what makes multi-word queries pinpoint).
+ *  Returns 0 when nothing matched (the caller drops those). */
+declare function scoreResource(r: DiscoveredResource, queryTokens: string[]): number;
+/**
+ * Rank resources by relevance to `query`, dropping non-matches and stamping each kept
+ * resource with its `score` (descending). Pure + stable: equal scores keep input order
+ * (so the dedupe's source priority survives a tie). No query → returned unchanged.
+ */
+declare function rankResources(items: DiscoveredResource[], query: string | undefined): DiscoveredResource[];
 /**
  * Register a resource on **402 Index** — the primary, friction-free path: a
  * single POST, no auth, no signature, no payment. A self-registered listing is
@@ -4687,6 +4775,14 @@ declare const REGISTER_ATTRIBUTION = "\u00B7 Built with @piprail/sdk";
  *  (≤ 500 chars). This is the only attribution an index actually DISPLAYS, so it's how a
  *  registered listing stays visibly "built with PipRail" — opt out with `attribution:false`. */
 declare function appendAttribution(description: string | undefined): string | undefined;
+/**
+ * Fold keyword tags into a description as a compact, searchable tail — `desc · Keywords:
+ * a, b, c` — because 402 Index search is literal (a term must appear in the name or
+ * description to match). Pure + tasteful: drops tags already present in the text
+ * (case-insensitive, no duplication), no-ops when there are no tags, and returns the
+ * description unchanged rather than overflow a sane listing cap (≤ 500 chars). When the
+ * description is empty it still seeds one from the tags (so they're not lost). */
+declare function appendKeywords(description: string | undefined, tags: string[] | undefined): string | undefined;
 
 interface PaymentPolicy {
     /** Per-payment ceiling, human-readable (e.g. '0.10'). Compared using the
@@ -5168,9 +5264,30 @@ interface DiscoverOptions {
      * figure before paying.
      */
     maxPrice?: number;
+    /** Keep ONLY this category, e.g. `'ai'` (prefix match) — strict: results the index
+     *  didn't categorize are dropped, so real category matches aren't drowned by un-tagged ones. */
+    category?: string;
+    /** Keep only resources paying in this asset symbol, e.g. `'USDC'` (keeps results whose
+     *  asset the index didn't report — confirm with `quote()`). */
+    asset?: string;
+    /** Drop results whose reliability score (0–100) is below this. Results with no reported
+     *  score pass through (Bazaar doesn't measure it); inspect `result.reliabilityScore`. */
+    minReliability?: number;
+    /** Prefer verified listings (402 Index server-side). Its `verified` flag differs from the
+     *  per-record `domain_verified`, so it's applied at the index; inspect `result.verified`. */
+    verified?: boolean;
+    /** Restrict to listings the index confirmed are payable x402 (402 Index `payment_valid`). */
+    paymentValid?: boolean;
+    /**
+     * Result ordering. Default `'relevance'` when a `query` is given (best matches first),
+     * else first-seen order. `'reliability'`/`'price'`/`'uptime'`/`'name'` sort by that field.
+     */
+    sort?: DiscoverySort;
+    /** Direction for a non-relevance `sort`. Default `'desc'`. */
+    order?: 'asc' | 'desc';
     /** Which open indexes to read. Default `['bazaar', '402index']` (both free). */
     sources?: DiscoverySource[];
-    /** Max results per source before merge. Default 20. */
+    /** Max results to fetch per index request. Default 20. */
     limit?: number;
 }
 /** Options for {@link PipRailClient.register}. */
@@ -5186,6 +5303,23 @@ interface RegisterOptions {
     network?: string;
     /** HTTP method the resource answers on. Default 'GET'. */
     method?: string;
+    /**
+     * A category for the listing, e.g. `'ai'`, `'finance'`, `'data'`. The highest-leverage
+     * findability field — most of 402 Index's catalog is `uncategorized`, so a real category
+     * makes a resource rank + filter where almost nothing else does.
+     */
+    category?: string;
+    /**
+     * Keywords for the listing. Folded into the description as a searchable tail (402 Index
+     * search is literal — a term must appear in the text to match) and sent as a `tags` field.
+     */
+    tags?: string[];
+    /** Who runs the resource (provider/org name). */
+    provider?: string;
+    /** Contact email for the listing. */
+    contactEmail?: string;
+    /** A JSON request body the index should send when health-checking a POST/PUT resource. */
+    probeBody?: unknown;
     /**
      * Which open indexes to list on. Default `['402index']` — no auth, no
      * signature. Add `'x402scan'` for the SIWX path (needs an EVM `discoverySigner`
@@ -5852,6 +5986,29 @@ interface SelfDescribeRail {
     /** A one-line instruction for paying THIS rail — chain-agnostic for `onchain-proof`. */
     how: string;
 }
+/**
+ * What the endpoint DOES — the agent-readability payload. Present only when the merchant
+ * described their resource (a `description`/`mimeType` on the gate, or a `discovery`
+ * descriptor with a `summary`/`queryParams`/`output`); absent on a zero-config gate, so
+ * the default 402 stays byte-identical. Lets an AI agent understand the endpoint's purpose,
+ * inputs, and output shape from the 402 alone — no paid call to find out what it returns.
+ */
+interface SelfDescribeEndpoint {
+    /** One human sentence: what this endpoint does. */
+    summary?: string;
+    /** HTTP method it answers on. */
+    method?: string;
+    /** The response content-type, e.g. 'application/json'. */
+    mimeType?: string;
+    /** Query params it reads, as a JSON-Schema `properties` object (name → schema). */
+    input?: Record<string, unknown>;
+    /** Output hint — shape/type and a concrete example (examples ground an LLM far better
+     *  than a schema alone). */
+    output?: {
+        type?: string;
+        example?: unknown;
+    };
+}
 /** The `extensions.piprail` self-description block. Inert, purely-additive metadata. */
 interface SelfDescription {
     name: 'PipRail';
@@ -5859,6 +6016,9 @@ interface SelfDescription {
     version: '2';
     /** One sentence: what this endpoint is. */
     what: string;
+    /** What the endpoint DOES (purpose · inputs · output) — see {@link SelfDescribeEndpoint}.
+     *  Only present when the merchant described the resource; absent on a zero-config gate. */
+    endpoint?: SelfDescribeEndpoint;
     /** Every rail the 402 offers, in the same order as `accepts[]`. */
     pay: SelfDescribeRail[];
     /** How to pay programmatically with the SDK. */
@@ -5893,7 +6053,31 @@ interface SelfDescription {
 declare function buildSelfDescription(input: {
     accepts: X402AnyAccept[];
     instruction?: string;
+    /** What the endpoint DOES — included only when non-empty (keeps the zero-config 402
+     *  byte-identical). Built from the gate's `description`/`mimeType`/`discovery` descriptor
+     *  via {@link buildEndpointInfo}. */
+    endpoint?: SelfDescribeEndpoint;
 }): SelfDescription;
+/**
+ * Assemble a {@link SelfDescribeEndpoint} from the pieces a gate knows — its
+ * `description`/`mimeType` and an optional `discovery` descriptor. Pure. Returns
+ * `undefined` when nothing was described, so the self-describe block (and thus the 402)
+ * stays byte-identical on a zero-config gate. The descriptor's `summary` wins over the
+ * gate `description` for the one-line "what it does".
+ */
+declare function buildEndpointInfo(input: {
+    description?: string;
+    mimeType?: string;
+    descriptor?: {
+        summary?: string;
+        method?: string;
+        queryParams?: Record<string, unknown>;
+        output?: {
+            type?: string;
+            example?: unknown;
+        };
+    };
+}): SelfDescribeEndpoint | undefined;
 
 /**
  * Discovery — make a gated resource FINDABLE, by emitting the open-standard
@@ -5946,6 +6130,8 @@ interface ResourceDescription {
     method?: string;
     /** Human description (shown to agents browsing an index). */
     description?: string;
+    /** Response content-type, e.g. 'application/json' (v2 ResourceInfo `mimeType`). */
+    mimeType?: string;
     /** The payment options the gate offers (its resolved `accepts`, nonce-free). */
     accepts: PaymentRail[];
 }
@@ -6042,6 +6228,10 @@ interface WellKnownX402 {
  * block in the 402 challenge) or build it directly with {@link buildBazaarExtension}.
  */
 interface DiscoveryDescriptor {
+    /** One human sentence: WHAT this endpoint does (e.g. "Current USD price for any
+     *  crypto ticker"). Surfaced in the `extensions.piprail` self-describe block so an
+     *  agent understands the endpoint at a glance, without a paid call. */
+    summary?: string;
     /** HTTP method the resource answers. Default `'GET'`. */
     method?: string;
     /** Query params the resource reads, as a JSON-Schema `properties` object
@@ -6222,8 +6412,12 @@ interface RequirePaymentOptions {
      *  G… Stellar, r… XRPL, T… Tron, account id on NEAR, 0x… Aptos, base32 Algorand).
      *  Required for the single form; the per-option fallback for the multi form. */
     payTo?: AddressId;
-    /** Shown to the agent in the challenge. */
+    /** Shown to the agent in the challenge. Also the one-line "what this endpoint does"
+     *  in the self-describe block (a `discovery` descriptor's `summary` overrides it). */
     description?: string;
+    /** Response content-type, e.g. 'application/json'. Emitted at the v2 root `resource.mimeType`
+     *  and in the self-describe `endpoint` so an agent knows how to parse the paid response. */
+    mimeType?: string;
     /** Confirmations required before access is granted. Default 1. */
     minConfirmations?: number;
     /** Max age of an accepted payment, in seconds. Default 600. */
@@ -7232,4 +7426,4 @@ declare const PERMIT2_WITNESS_TYPES: {
  */
 declare function renderLandingPage(sd: SelfDescription): string;
 
-export { type AcceptOption, type AddressId, type AgentTool, type AlgorandToken, type AptosToken, type AssetId, BRAND, type BazaarExtension, type BuildExactParams, CHAINS, type Caip2, type ChainFamily, type ChainInput, type ChainName, type ChainPreset, type ChainSelector, type ChallengeTriage, type ChallengeVerdict, type ConfirmInfo, ConfirmationTimeoutError, type CostEstimate, DIRECTORY_INFO, type DeclineReasonCode, type DeliverAttempt, type DeliverReceiptOptions, type DeliverResult, type DirectoryInfo, type DiscoverOptions, type DiscoveredRail, type DiscoveredResource, type DiscoveryDescriptor, type DiscoverySigner, type DiscoverySource, type DomainClaim, type DomainVerification, EIP3009_TYPES, EXACT_NETWORK_SLUGS, type EvmToken, type ExactAccept, type ExactAuthorization, type ExactAuthorizationWire, type ExactPaymentPayload, type ExactPaymentPayloadAny, type ExactRailOption, type ExpressLikeMiddleware, type ExpressLikeNext, type ExpressLikeRequest, type ExpressLikeResponse, type FacilitatorConfig, type FacilitatorPaymentRequirements, type FacilitatorSupportedKind, GENERATOR, HEADER_REQUIRED, HEADER_RESPONSE, HEADER_RESPONSE_V1, HEADER_SIGNATURE, HEADER_SIGNATURE_V1, InsufficientFundsError, InvalidEnvelopeError, KNOWN_FACILITATORS, type KnownFacilitator, type ListingVisibility, type ManifestInput, MaxRetriesExceededError, MissingDriverError, MultiChainPayer, type MultiChainPayerOptions, type NearToken, NoCompatibleAcceptError, NonReplayableBodyError, type OpenApiDocument, type OpenApiOperation, PERMIT2_ADDRESS, PERMIT2_PROXY_CHAIN_IDS, PERMIT2_WITNESS_TYPES, PIPRAIL_AGENT_GUIDE, POWERED_BY, type PaidReceipt, type ParsedExactPayment, type PayBlocker, type PayOption, type PayWarning, type PayingClient, PaymentDeclinedError, type PaymentDriver, type PaymentGate, type PaymentIntent, type PaymentPlan, type PaymentPolicy, type PaymentRail, type PaymentScheme, PaymentTimeoutError, type Permit2Authorization, type Permit2PaymentPayload, PipRailClient, type PipRailClientOptions, type PipRailCostQuote, PipRailError, type PipRailEvent, type PipRailQuote, type PolicyDecision, type PolicyDenyCode, REGISTER_ATTRIBUTION, RecipientNotReadyError, type RecipientReason, type RegisterInput, type RegisterOptions, type RegisterOutcome, type RequirePaymentOptions, type ResolveOptions, type ResolvedChain, type ResolvedNetwork, type ResolvedToken, type ResourceDescription, type SearchOpenIndexesOptions, type SelfDescribeRail, type SelfDescription, type SessionBudget, type SettleOutcome, type SettleViaFacilitatorInput, SettlementError, type SolanaToken, type SpendAssetTotal, type SpendRecord, type SpendRemaining, type SpendSummary, type StellarToken, type SuiToken, type TokenInfo, type TokenInput, type TonToken, type ToolAnnotations, type TronToken, UnknownTokenError, UnsupportedNetworkError, UnsupportedSchemeError, type VerifyErrorCode, type VerifyPaymentResult, type VerifyResult, type WalletBalance, type WalletHandle, type WalletInput, WalletRequiredError, type WellKnownX402, WrongChainError, WrongFamilyError, type X402AcceptEntry, type X402AnyAccept, type X402Challenge, type X402DnsRecord, type X402ExactAcceptEntry, type X402InvalidBody, type X402PaymentSignature, type X402Receipt, type X402ResourceObject, X402_EXACT_PERMIT2_PROXY, type XrplToken, agentGuide, appendAttribution, buildBazaarExtension, buildChallengeHeader, buildExactAuthorization, buildExactSignatureHeader, buildOpenApi, buildReceiptHeader, buildSelfDescription, buildSignatureHeader, buildWellKnownX402, buildX402DnsTxt, chainIdForExactNetwork, claim402IndexDomain, classifyChallenge, createPaymentGate, decorateOutcome, deliverReceipt, describeChallenge, discoveryHeaders, eip3009Abi, encodeXPaymentHeader, evaluatePolicy, explainDecline, facilitatorCoverage, fetchAcross, firstKeylessFacilitator, formatSpendReport, getDirectoryInfo, isPermit2ProxyChain, knownFacilitatorsFor, normalizeNetwork, parseChallenge, parseExactPaymentHeader, parseExactRequirements, parseFacilitatorSupported, parseReceipt, parseSettleResponse, parseSignatureHeader, paymentTools, pickAccept, planAcross, readExactDomain, register402Index, registerDriver, registerX402Scan, renderLandingPage, requirePayment, resolveChain, searchOpenIndexes, settleViaFacilitator, summarizePlan, toInsufficientFundsError, toInvalidBody, verify402IndexDomain };
+export { type AcceptOption, type AddressId, type AgentTool, type AlgorandToken, type AptosToken, type AssetId, BRAND, type BazaarExtension, type BuildExactParams, CHAINS, type Caip2, type ChainFamily, type ChainInput, type ChainName, type ChainPreset, type ChainSelector, type ChallengeTriage, type ChallengeVerdict, type ConfirmInfo, ConfirmationTimeoutError, type CostEstimate, DIRECTORY_INFO, type DeclineReasonCode, type DeliverAttempt, type DeliverReceiptOptions, type DeliverResult, type DirectoryInfo, type DiscoverOptions, type DiscoveredRail, type DiscoveredResource, type DiscoveryDescriptor, type DiscoverySigner, type DiscoverySort, type DiscoverySource, type DomainClaim, type DomainVerification, EIP3009_TYPES, EXACT_NETWORK_SLUGS, type EvmToken, type ExactAccept, type ExactAuthorization, type ExactAuthorizationWire, type ExactPaymentPayload, type ExactPaymentPayloadAny, type ExactRailOption, type ExpressLikeMiddleware, type ExpressLikeNext, type ExpressLikeRequest, type ExpressLikeResponse, type FacilitatorConfig, type FacilitatorPaymentRequirements, type FacilitatorSupportedKind, GENERATOR, HEADER_REQUIRED, HEADER_RESPONSE, HEADER_RESPONSE_V1, HEADER_SIGNATURE, HEADER_SIGNATURE_V1, InsufficientFundsError, InvalidEnvelopeError, KNOWN_FACILITATORS, type KnownFacilitator, type ListingVisibility, type ManifestInput, MaxRetriesExceededError, MissingDriverError, MultiChainPayer, type MultiChainPayerOptions, type NearToken, NoCompatibleAcceptError, NonReplayableBodyError, type OpenApiDocument, type OpenApiOperation, PERMIT2_ADDRESS, PERMIT2_PROXY_CHAIN_IDS, PERMIT2_WITNESS_TYPES, PIPRAIL_AGENT_GUIDE, POWERED_BY, type PaidReceipt, type ParsedExactPayment, type PayBlocker, type PayOption, type PayWarning, type PayingClient, PaymentDeclinedError, type PaymentDriver, type PaymentGate, type PaymentIntent, type PaymentPlan, type PaymentPolicy, type PaymentRail, type PaymentScheme, PaymentTimeoutError, type Permit2Authorization, type Permit2PaymentPayload, PipRailClient, type PipRailClientOptions, type PipRailCostQuote, PipRailError, type PipRailEvent, type PipRailQuote, type PolicyDecision, type PolicyDenyCode, REGISTER_ATTRIBUTION, RecipientNotReadyError, type RecipientReason, type RegisterInput, type RegisterOptions, type RegisterOutcome, type RequirePaymentOptions, type ResolveOptions, type ResolvedChain, type ResolvedNetwork, type ResolvedToken, type ResourceDescription, type SearchOpenIndexesOptions, type SelfDescribeEndpoint, type SelfDescribeRail, type SelfDescription, type SessionBudget, type SettleOutcome, type SettleViaFacilitatorInput, SettlementError, type SolanaToken, type SpendAssetTotal, type SpendRecord, type SpendRemaining, type SpendSummary, type StellarToken, type SuiToken, type TokenInfo, type TokenInput, type TonToken, type ToolAnnotations, type TronToken, UnknownTokenError, UnsupportedNetworkError, UnsupportedSchemeError, type VerifyErrorCode, type VerifyPaymentResult, type VerifyResult, type WalletBalance, type WalletHandle, type WalletInput, WalletRequiredError, type WellKnownX402, WrongChainError, WrongFamilyError, type X402AcceptEntry, type X402AnyAccept, type X402Challenge, type X402DnsRecord, type X402ExactAcceptEntry, type X402InvalidBody, type X402PaymentSignature, type X402Receipt, type X402ResourceObject, X402_EXACT_PERMIT2_PROXY, type XrplToken, agentGuide, appendAttribution, appendKeywords, buildBazaarExtension, buildChallengeHeader, buildEndpointInfo, buildExactAuthorization, buildExactSignatureHeader, buildOpenApi, buildReceiptHeader, buildSelfDescription, buildSignatureHeader, buildWellKnownX402, buildX402DnsTxt, chainIdForExactNetwork, claim402IndexDomain, classifyChallenge, createPaymentGate, decorateOutcome, deliverReceipt, describeChallenge, discoveryHeaders, eip3009Abi, encodeXPaymentHeader, evaluatePolicy, explainDecline, facilitatorCoverage, fetchAcross, firstKeylessFacilitator, formatSpendReport, getDirectoryInfo, isPermit2ProxyChain, knownFacilitatorsFor, normalizeNetwork, parseChallenge, parseExactPaymentHeader, parseExactRequirements, parseFacilitatorSupported, parseReceipt, parseSettleResponse, parseSignatureHeader, paymentTools, pickAccept, planAcross, rankResources, readExactDomain, register402Index, registerDriver, registerX402Scan, renderLandingPage, requirePayment, resolveChain, scoreResource, searchOpenIndexes, settleViaFacilitator, summarizePlan, toInsufficientFundsError, toInvalidBody, verify402IndexDomain };