uvd-x402-sdk 2.109.0 → 2.111.0

package/README.md

@@ -10,7 +10,7 @@ Users sign a message or transaction, and the Ultravioleta facilitator handles on
 
 ## Features
 
-**Arras NEAR escrow (v2.108.0):** offline local-key NEP-366 authorization, canonical Rust payment IDs and pull lifecycle helpers through `uvd-x402-sdk/near`. [Guide and agent example](docs/near-escrow.md). As of 2026-11-02 the facilitator advertises escrow only on testnet, and the SDK's escrow contract registry has no mainnet row yet.
+**Arras NEAR escrow (v2.110.0):** offline local-key NEP-366 authorization, canonical Rust payment IDs and pull lifecycle helpers through `uvd-x402-sdk/near`. [Guide and agent example](docs/near-escrow.md). As of 2026-11-03 the production facilitator relays NEAR escrow only on testnet. Since 2.110.0 the registry allows mainnet escrow signing only for `v1.arras-escrow.near`; testnet keeps `arras-v1b-1101.testnet`.
 
 - **31 Networks**: EVM (19 including HashKey Chain, Arc, Scroll, SKALE Base, Robinhood Chain), Solana, Fogo, Stellar, NEAR, Algorand, Sui, XRP Ledger, Hedera (mainnet + testnet)
 - **Multi-Stablecoin**: USDC, EURC, AUSD, PYUSD, USDT, USDG (Robinhood Chain)

package/dist/providers/near/index.d.mts

@@ -65,7 +65,7 @@ declare const NEAR_ESCROW_TOKENS: Readonly<Record<NearEscrowNetwork, string>>;
 /**
  * The Arras escrow deployments this SDK signs for, per network. Any other escrowContract is refused before the
  * signer is called, for authorization and lifecycle alike: a signed delegate can be relayed by anyone, so a 402
- * server must not be able to point it at its own account. Mainnet stays empty until its contract ships in a release.
+ * server must not be able to point it at its own account. Only deployed Arras v1 contracts are registered.
  */
 declare const NEAR_ESCROW_CONTRACTS: Readonly<Record<NearEscrowNetwork, readonly string[]>>;
 /** Canonical Arras JSON: field order, decimal-string timestamps, lowercase hex, no spaces. */
@@ -154,7 +154,7 @@ interface NearStorageOptions {
     /** YoctoNEAR, not NEAR. Query storage_balance_bounds for the live contract minimum. */
     deposit?: NearUnsigned;
 }
-/** Explicit trusted deployment configuration; this unsigned builder does not select an account parent. */
+/** Explicit deployment from NEAR_ESCROW_CONTRACTS for the selected network. */
 interface ArrasStorageOptions extends NearStorageOptions {
     escrowContract: string;
 }
@@ -244,6 +244,242 @@ type ArrasEvent = {
  */
 declare function parseArrasEvents(logs: readonly unknown[]): ArrasEvent[];
 
+declare const NEAR_REGISTRY_CONTRACTS: Readonly<Record<NearEscrowNetwork, readonly string[]>>;
+declare const NEAR_REGISTRY_ESCROWS: Readonly<Record<NearEscrowNetwork, readonly string[]>>;
+declare const REGISTER_DEPOSIT = "17510000000000000000000";
+declare const FEEDBACK_DEPOSIT = "18640000000000000000000";
+declare const REGISTRY_GAS = "30000000000000";
+declare const GIVE_FEEDBACK_GAS = "100000000000000";
+declare const MIN_GIVE_FEEDBACK_GAS = "60000000000000";
+declare enum RegistryErrorCode {
+    E01 = "E01_AGENT_URI_INVALIDA",
+    E02 = "E02_METADATA_INVALIDA",
+    E03 = "E03_YA_REGISTRADO",
+    E04 = "E04_NO_REGISTRADO",
+    E05 = "E05_DEPOSITO_INSUFICIENTE",
+    E06 = "E06_REQUIERE_DEPOSITO",
+    E10 = "E10_ESCROW_NO_PERMITIDO",
+    E11 = "E11_PAYMENT_ID_INVALIDO",
+    E12 = "E12_SCORE_INVALIDO",
+    E13 = "E13_TAG_INVALIDO",
+    E14 = "E14_FEEDBACK_URI_INVALIDA",
+    E15 = "E15_FEEDBACK_HASH_INVALIDO",
+    E16 = "E16_DEPOSITO_FEEDBACK",
+    E17 = "E17_GAS_INSUFICIENTE",
+    E18 = "E18_YA_CALIFICADO",
+    E19 = "E19_EN_VUELO",
+    E20 = "E20_GET_PAYMENT_FALLO",
+    E21 = "E21_RESPUESTA_INVALIDA",
+    E22 = "E22_PAGO_INEXISTENTE",
+    E23 = "E23_PAGO_SIN_LIBERAR",
+    E24 = "E24_NO_ES_PARTE",
+    E25 = "E25_AUTO_CALIFICACION",
+    E26 = "E26_REEMPLAZADO",
+    E30 = "E30_FEEDBACK_INEXISTENTE",
+    E31 = "E31_YA_REVOCADO",
+    E40 = "E40_ESCROWS_INVALIDOS"
+}
+declare class RegistryValidationError extends Error {
+    readonly code: RegistryErrorCode;
+    constructor(code: RegistryErrorCode);
+}
+interface RegistryTarget {
+    network: NearEscrowNetwork;
+    registryContract?: string;
+}
+interface RegistryBuildOptions extends RegistryTarget {
+    signerId: string;
+    /** YoctoNEAR: register/feedback use getConfig floors; update accepts >= 1; revoke requires 1. */
+    deposit?: NearUnsigned;
+    /** Gas units, not TGas. give_feedback needs at least 60 TGas. */
+    gas?: NearUnsigned;
+}
+interface RegistryIdentityArgs {
+    agent_uri: string;
+    metadata?: string | null;
+}
+interface RegistryPaymentArgs {
+    escrow: string;
+    payment_id: string;
+}
+interface GiveFeedbackArgs extends RegistryPaymentArgs {
+    score: number;
+    tag1?: string | null;
+    tag2?: string | null;
+    feedback_uri?: string | null;
+    feedback_hash?: string | null;
+}
+type RegistryMethod = 'register' | 'update' | 'give_feedback' | 'revoke_feedback';
+interface RegistryTransaction {
+    signerId: string;
+    receiverId: string;
+    actions: [
+        {
+            type: 'FunctionCall';
+            params: {
+                methodName: RegistryMethod;
+                args: Record<string, string | number>;
+                gas: string;
+                deposit: string;
+            };
+        }
+    ];
+}
+declare const buildRegistryRegister: (options: RegistryBuildOptions & RegistryIdentityArgs) => RegistryTransaction;
+/** Replaces URI and metadata. Omitted/null metadata clears the previous value. */
+declare const buildRegistryUpdate: (options: RegistryBuildOptions & RegistryIdentityArgs) => RegistryTransaction;
+declare const buildGiveFeedback: (options: RegistryBuildOptions & GiveFeedbackArgs) => RegistryTransaction;
+declare const buildRevokeFeedback: (options: RegistryBuildOptions & RegistryPaymentArgs) => RegistryTransaction;
+/**
+ * Normal SignedTransaction Borsh, base64 for send_tx. No NEP-366 prefix, RPC or submission.
+ * The access key MUST be FullAccess: FunctionCall keys cannot attach a deposit. The caller
+ * verifies access-key permission and supplies the next nonce and a recent base58 block hash.
+ * Revalidates the descriptor before asking the signer to sign, and verifies the returned signature.
+ */
+declare function signRegistryTransaction(descriptor: RegistryTransaction, signer: NearLocalSigner, nonce: NearUnsigned, blockHash: string): Promise<string>;
+interface AgentView {
+    account_id: string;
+    agent_uri: string;
+    metadata: string | null;
+    registered_at: string;
+    updated_at: string;
+}
+interface FeedbackView {
+    feedback_id: number;
+    rater: string;
+    ratee: string;
+    ratee_role: 'payer' | 'receiver';
+    escrow: string;
+    payment_id: string;
+    operator_id: string;
+    released: string;
+    score: number;
+    tag1: string | null;
+    tag2: string | null;
+    feedback_uri: string | null;
+    feedback_hash: string | null;
+    created_at: string;
+    revoked: boolean;
+    revoked_at: string | null;
+}
+interface RoleSummaryView {
+    count: number;
+    revoked: number;
+    score_sum: string;
+    average_x100: number | null;
+}
+interface SummaryView extends RoleSummaryView {
+    account_id: string;
+    operator_id?: string;
+    as_payer: RoleSummaryView;
+    as_receiver: RoleSummaryView;
+    last_feedback_id: number | null;
+    last_at: string | null;
+}
+interface RegistryConfigView {
+    version: 'arras-registry-v1';
+    escrows: string[];
+    agents: number;
+    feedbacks: number;
+    register_deposit: string;
+    feedback_deposit: string;
+    min_gas_give_feedback: string;
+    limits: {
+        max_agent_uri_len: number;
+        max_metadata_len: number;
+        max_feedback_uri_len: number;
+        max_tag_len: number;
+        max_payment_id_len: number;
+        max_score: number;
+        max_list_limit: number;
+        pending_ttl_blocks: string;
+    };
+}
+/** Return the JSON-RPC result (call_function response with result: number[]), not its outer envelope. */
+type RegistryRpc = (method: string, params: Record<string, unknown>) => Promise<unknown>;
+interface RegistryViewOptions extends RegistryTarget {
+    rpc?: RegistryRpc;
+}
+interface RegistryPage {
+    from_index?: number;
+    limit?: number;
+}
+declare const getConfig: (o: RegistryViewOptions) => Promise<RegistryConfigView>;
+declare const getAgent: (o: RegistryViewOptions, accountId: string) => Promise<AgentView | null>;
+declare const listAgents: (o: RegistryViewOptions, p?: RegistryPage) => Promise<AgentView[]>;
+declare const getFeedback: (o: RegistryViewOptions, feedbackId: number) => Promise<FeedbackView | null>;
+declare const getFeedbackForPayment: (o: RegistryViewOptions, p: RegistryPaymentArgs & {
+    rater: string;
+}) => Promise<FeedbackView | null>;
+declare const listFeedback: (o: RegistryViewOptions, accountId: string, p?: RegistryPage) => Promise<FeedbackView[]>;
+declare const getSummary: (o: RegistryViewOptions, accountId: string) => Promise<SummaryView>;
+declare const getSummaryByOperator: (o: RegistryViewOptions, accountId: string, operatorId: string) => Promise<SummaryView>;
+declare const isFeedbackPending: (o: RegistryViewOptions, p: RegistryPaymentArgs & {
+    rater: string;
+}) => Promise<boolean>;
+interface RegistryEventData {
+    agent_registered: {
+        account_id: string;
+        agent_uri: string;
+        metadata: string | null;
+        at: string;
+    };
+    agent_updated: RegistryEventData['agent_registered'];
+    feedback_given: Omit<FeedbackView, 'revoked' | 'revoked_at'>;
+    feedback_revoked: Pick<FeedbackView, 'feedback_id' | 'rater' | 'ratee' | 'escrow' | 'payment_id'> & {
+        revoked_at: string;
+    };
+}
+type RegistryEvent = {
+    [K in keyof RegistryEventData]: {
+        standard: 'arras-registry';
+        version: '1.0.0';
+        event: K;
+        data: RegistryEventData[K][];
+    };
+}[keyof RegistryEventData];
+/**
+ * Skip malformed/foreign/unknown logs; preserve valid batches. Raw logs are safe only
+ * when the caller has already filtered receipts by executor_id for the selected network
+ * and successful execution status.
+ * Prefer parseRegistryReceiptEvents for transaction receipts_outcome from the RPC.
+ */
+declare function parseRegistryEvents(logs: readonly unknown[]): RegistryEvent[];
+/** Parse RPC receipts_outcome, accepting only successful receipts from the selected network's registries. */
+declare function parseRegistryReceiptEvents(receiptsOutcome: unknown, net: NearEscrowNetwork): RegistryEvent[];
+type GiveFeedbackOutcome = {
+    status: 'accepted';
+    feedbackId: number;
+} | {
+    status: 'rejected';
+    code: RegistryErrorCode;
+} | {
+    status: 'error';
+    code: RegistryErrorCode;
+    message: string;
+};
+/** Accept a decoded number, {value, logs}, or the final NEAR execution outcome (not a pending send_tx result). */
+declare function parseGiveFeedbackOutcome(outcome: unknown): GiveFeedbackOutcome;
+interface FeedbackSummary {
+    count: number;
+    distinct_raters: number;
+    revoked: number;
+    released_total: string;
+    average_x100: number | null;
+    weighted_average_x100: number | null;
+}
+/**
+ * Summarize the supplied rows for one escrow/operator. Revoked rows only increment revoked.
+ * Active rows count equally in average_x100; released weights weighted_average_x100. Both
+ * use exact bigint sums and floor. No deduplication/pagination: supply each feedback once,
+ * for the intended ratee. Zero total weight returns null, as does an empty active set.
+ */
+declare function summarizeFeedback(feedbacks: readonly FeedbackView[], escrow: string, operatorId: string): FeedbackSummary;
+/** Allow only display links with these schemes; never normalize contract bytes or accept whitespace. */
+declare function safeLink(uri: string): string | null;
+/** Plain text only; remove Unicode control/format characters (including bidi and zero width). Not HTML escaping. */
+declare function displayText(s: string): string;
+
 /**
  * uvd-x402-sdk - NEAR Provider
  *
@@ -382,4 +618,4 @@ declare class NEARProvider implements WalletAdapter {
     private base58Encode;
 }
 
-export { type ArrasAuthorizedData, type ArrasCapsSetData, type ArrasCompactedData, type ArrasEvent, type ArrasEventData, type ArrasOperatorData, type ArrasPauseData, type ArrasPaymentAmountData, type ArrasReleasedData, type ArrasStorageOptions, type ArrasWithdrawnData, type AuthorizeFromBudget, type EscrowAuthorizationOptions, type EscrowMsgParams, NEARProvider, NEAR_ARRAS_STORAGE_DEPOSIT, NEAR_ESCROW_CONTRACTS, NEAR_ESCROW_MAX_GAS, NEAR_ESCROW_MIN_GAS, NEAR_ESCROW_TOKENS, NEAR_USDC_STORAGE_DEPOSIT, type NearEscrowDelegate, type NearEscrowDelegateOptions, type NearEscrowFunctionCall, type NearEscrowLifecycleMethod, type NearEscrowNetwork, type NearEscrowPayment, type NearExactDelegateOptions, type NearExactPayment, type NearLocalSigner, type NearStorageOptions, type NearStorageTransaction, type NearUnsigned, type Nep413Message, type Nep413SignedMessage, type PaymentIdParams, type SignNep413Options, type WalletSelectorOptions, buildArrasStorageDeposit, buildEscrowAuthorizationDelegate, buildEscrowMsg, buildUsdcStorageDeposit, computePaymentId, createNearLocalSigner, NEARProvider as default, nep413Preimage, parseArrasEvents, paymentIdPreimage, reclaim, refund, release, signEscrowAuthorization, signEscrowLifecycle, signExactNearDelegate, signNep413, validateEscrowAuthorizationDelegate, withdraw, withdrawFor };
+export { type AgentView, type ArrasAuthorizedData, type ArrasCapsSetData, type ArrasCompactedData, type ArrasEvent, type ArrasEventData, type ArrasOperatorData, type ArrasPauseData, type ArrasPaymentAmountData, type ArrasReleasedData, type ArrasStorageOptions, type ArrasWithdrawnData, type AuthorizeFromBudget, type EscrowAuthorizationOptions, type EscrowMsgParams, FEEDBACK_DEPOSIT, type FeedbackSummary, type FeedbackView, GIVE_FEEDBACK_GAS, type GiveFeedbackArgs, type GiveFeedbackOutcome, MIN_GIVE_FEEDBACK_GAS, NEARProvider, NEAR_ARRAS_STORAGE_DEPOSIT, NEAR_ESCROW_CONTRACTS, NEAR_ESCROW_MAX_GAS, NEAR_ESCROW_MIN_GAS, NEAR_ESCROW_TOKENS, NEAR_REGISTRY_CONTRACTS, NEAR_REGISTRY_ESCROWS, NEAR_USDC_STORAGE_DEPOSIT, type NearEscrowDelegate, type NearEscrowDelegateOptions, type NearEscrowFunctionCall, type NearEscrowLifecycleMethod, type NearEscrowNetwork, type NearEscrowPayment, type NearExactDelegateOptions, type NearExactPayment, type NearLocalSigner, type NearStorageOptions, type NearStorageTransaction, type NearUnsigned, type Nep413Message, type Nep413SignedMessage, type PaymentIdParams, REGISTER_DEPOSIT, REGISTRY_GAS, type RegistryBuildOptions, type RegistryConfigView, RegistryErrorCode, type RegistryEvent, type RegistryEventData, type RegistryIdentityArgs, type RegistryMethod, type RegistryPage, type RegistryPaymentArgs, type RegistryRpc, type RegistryTarget, type RegistryTransaction, RegistryValidationError, type RegistryViewOptions, type RoleSummaryView, type SignNep413Options, type SummaryView, type WalletSelectorOptions, buildArrasStorageDeposit, buildEscrowAuthorizationDelegate, buildEscrowMsg, buildGiveFeedback, buildRegistryRegister, buildRegistryUpdate, buildRevokeFeedback, buildUsdcStorageDeposit, computePaymentId, createNearLocalSigner, NEARProvider as default, displayText, getAgent, getConfig, getFeedback, getFeedbackForPayment, getSummary, getSummaryByOperator, isFeedbackPending, listAgents, listFeedback, nep413Preimage, parseArrasEvents, parseGiveFeedbackOutcome, parseRegistryEvents, parseRegistryReceiptEvents, paymentIdPreimage, reclaim, refund, release, safeLink, signEscrowAuthorization, signEscrowLifecycle, signExactNearDelegate, signNep413, signRegistryTransaction, summarizeFeedback, validateEscrowAuthorizationDelegate, withdraw, withdrawFor };

package/dist/providers/near/index.d.ts

@@ -65,7 +65,7 @@ declare const NEAR_ESCROW_TOKENS: Readonly<Record<NearEscrowNetwork, string>>;
 /**
  * The Arras escrow deployments this SDK signs for, per network. Any other escrowContract is refused before the
  * signer is called, for authorization and lifecycle alike: a signed delegate can be relayed by anyone, so a 402
- * server must not be able to point it at its own account. Mainnet stays empty until its contract ships in a release.
+ * server must not be able to point it at its own account. Only deployed Arras v1 contracts are registered.
  */
 declare const NEAR_ESCROW_CONTRACTS: Readonly<Record<NearEscrowNetwork, readonly string[]>>;
 /** Canonical Arras JSON: field order, decimal-string timestamps, lowercase hex, no spaces. */
@@ -154,7 +154,7 @@ interface NearStorageOptions {
     /** YoctoNEAR, not NEAR. Query storage_balance_bounds for the live contract minimum. */
     deposit?: NearUnsigned;
 }
-/** Explicit trusted deployment configuration; this unsigned builder does not select an account parent. */
+/** Explicit deployment from NEAR_ESCROW_CONTRACTS for the selected network. */
 interface ArrasStorageOptions extends NearStorageOptions {
     escrowContract: string;
 }
@@ -244,6 +244,242 @@ type ArrasEvent = {
  */
 declare function parseArrasEvents(logs: readonly unknown[]): ArrasEvent[];
 
+declare const NEAR_REGISTRY_CONTRACTS: Readonly<Record<NearEscrowNetwork, readonly string[]>>;
+declare const NEAR_REGISTRY_ESCROWS: Readonly<Record<NearEscrowNetwork, readonly string[]>>;
+declare const REGISTER_DEPOSIT = "17510000000000000000000";
+declare const FEEDBACK_DEPOSIT = "18640000000000000000000";
+declare const REGISTRY_GAS = "30000000000000";
+declare const GIVE_FEEDBACK_GAS = "100000000000000";
+declare const MIN_GIVE_FEEDBACK_GAS = "60000000000000";
+declare enum RegistryErrorCode {
+    E01 = "E01_AGENT_URI_INVALIDA",
+    E02 = "E02_METADATA_INVALIDA",
+    E03 = "E03_YA_REGISTRADO",
+    E04 = "E04_NO_REGISTRADO",
+    E05 = "E05_DEPOSITO_INSUFICIENTE",
+    E06 = "E06_REQUIERE_DEPOSITO",
+    E10 = "E10_ESCROW_NO_PERMITIDO",
+    E11 = "E11_PAYMENT_ID_INVALIDO",
+    E12 = "E12_SCORE_INVALIDO",
+    E13 = "E13_TAG_INVALIDO",
+    E14 = "E14_FEEDBACK_URI_INVALIDA",
+    E15 = "E15_FEEDBACK_HASH_INVALIDO",
+    E16 = "E16_DEPOSITO_FEEDBACK",
+    E17 = "E17_GAS_INSUFICIENTE",
+    E18 = "E18_YA_CALIFICADO",
+    E19 = "E19_EN_VUELO",
+    E20 = "E20_GET_PAYMENT_FALLO",
+    E21 = "E21_RESPUESTA_INVALIDA",
+    E22 = "E22_PAGO_INEXISTENTE",
+    E23 = "E23_PAGO_SIN_LIBERAR",
+    E24 = "E24_NO_ES_PARTE",
+    E25 = "E25_AUTO_CALIFICACION",
+    E26 = "E26_REEMPLAZADO",
+    E30 = "E30_FEEDBACK_INEXISTENTE",
+    E31 = "E31_YA_REVOCADO",
+    E40 = "E40_ESCROWS_INVALIDOS"
+}
+declare class RegistryValidationError extends Error {
+    readonly code: RegistryErrorCode;
+    constructor(code: RegistryErrorCode);
+}
+interface RegistryTarget {
+    network: NearEscrowNetwork;
+    registryContract?: string;
+}
+interface RegistryBuildOptions extends RegistryTarget {
+    signerId: string;
+    /** YoctoNEAR: register/feedback use getConfig floors; update accepts >= 1; revoke requires 1. */
+    deposit?: NearUnsigned;
+    /** Gas units, not TGas. give_feedback needs at least 60 TGas. */
+    gas?: NearUnsigned;
+}
+interface RegistryIdentityArgs {
+    agent_uri: string;
+    metadata?: string | null;
+}
+interface RegistryPaymentArgs {
+    escrow: string;
+    payment_id: string;
+}
+interface GiveFeedbackArgs extends RegistryPaymentArgs {
+    score: number;
+    tag1?: string | null;
+    tag2?: string | null;
+    feedback_uri?: string | null;
+    feedback_hash?: string | null;
+}
+type RegistryMethod = 'register' | 'update' | 'give_feedback' | 'revoke_feedback';
+interface RegistryTransaction {
+    signerId: string;
+    receiverId: string;
+    actions: [
+        {
+            type: 'FunctionCall';
+            params: {
+                methodName: RegistryMethod;
+                args: Record<string, string | number>;
+                gas: string;
+                deposit: string;
+            };
+        }
+    ];
+}
+declare const buildRegistryRegister: (options: RegistryBuildOptions & RegistryIdentityArgs) => RegistryTransaction;
+/** Replaces URI and metadata. Omitted/null metadata clears the previous value. */
+declare const buildRegistryUpdate: (options: RegistryBuildOptions & RegistryIdentityArgs) => RegistryTransaction;
+declare const buildGiveFeedback: (options: RegistryBuildOptions & GiveFeedbackArgs) => RegistryTransaction;
+declare const buildRevokeFeedback: (options: RegistryBuildOptions & RegistryPaymentArgs) => RegistryTransaction;
+/**
+ * Normal SignedTransaction Borsh, base64 for send_tx. No NEP-366 prefix, RPC or submission.
+ * The access key MUST be FullAccess: FunctionCall keys cannot attach a deposit. The caller
+ * verifies access-key permission and supplies the next nonce and a recent base58 block hash.
+ * Revalidates the descriptor before asking the signer to sign, and verifies the returned signature.
+ */
+declare function signRegistryTransaction(descriptor: RegistryTransaction, signer: NearLocalSigner, nonce: NearUnsigned, blockHash: string): Promise<string>;
+interface AgentView {
+    account_id: string;
+    agent_uri: string;
+    metadata: string | null;
+    registered_at: string;
+    updated_at: string;
+}
+interface FeedbackView {
+    feedback_id: number;
+    rater: string;
+    ratee: string;
+    ratee_role: 'payer' | 'receiver';
+    escrow: string;
+    payment_id: string;
+    operator_id: string;
+    released: string;
+    score: number;
+    tag1: string | null;
+    tag2: string | null;
+    feedback_uri: string | null;
+    feedback_hash: string | null;
+    created_at: string;
+    revoked: boolean;
+    revoked_at: string | null;
+}
+interface RoleSummaryView {
+    count: number;
+    revoked: number;
+    score_sum: string;
+    average_x100: number | null;
+}
+interface SummaryView extends RoleSummaryView {
+    account_id: string;
+    operator_id?: string;
+    as_payer: RoleSummaryView;
+    as_receiver: RoleSummaryView;
+    last_feedback_id: number | null;
+    last_at: string | null;
+}
+interface RegistryConfigView {
+    version: 'arras-registry-v1';
+    escrows: string[];
+    agents: number;
+    feedbacks: number;
+    register_deposit: string;
+    feedback_deposit: string;
+    min_gas_give_feedback: string;
+    limits: {
+        max_agent_uri_len: number;
+        max_metadata_len: number;
+        max_feedback_uri_len: number;
+        max_tag_len: number;
+        max_payment_id_len: number;
+        max_score: number;
+        max_list_limit: number;
+        pending_ttl_blocks: string;
+    };
+}
+/** Return the JSON-RPC result (call_function response with result: number[]), not its outer envelope. */
+type RegistryRpc = (method: string, params: Record<string, unknown>) => Promise<unknown>;
+interface RegistryViewOptions extends RegistryTarget {
+    rpc?: RegistryRpc;
+}
+interface RegistryPage {
+    from_index?: number;
+    limit?: number;
+}
+declare const getConfig: (o: RegistryViewOptions) => Promise<RegistryConfigView>;
+declare const getAgent: (o: RegistryViewOptions, accountId: string) => Promise<AgentView | null>;
+declare const listAgents: (o: RegistryViewOptions, p?: RegistryPage) => Promise<AgentView[]>;
+declare const getFeedback: (o: RegistryViewOptions, feedbackId: number) => Promise<FeedbackView | null>;
+declare const getFeedbackForPayment: (o: RegistryViewOptions, p: RegistryPaymentArgs & {
+    rater: string;
+}) => Promise<FeedbackView | null>;
+declare const listFeedback: (o: RegistryViewOptions, accountId: string, p?: RegistryPage) => Promise<FeedbackView[]>;
+declare const getSummary: (o: RegistryViewOptions, accountId: string) => Promise<SummaryView>;
+declare const getSummaryByOperator: (o: RegistryViewOptions, accountId: string, operatorId: string) => Promise<SummaryView>;
+declare const isFeedbackPending: (o: RegistryViewOptions, p: RegistryPaymentArgs & {
+    rater: string;
+}) => Promise<boolean>;
+interface RegistryEventData {
+    agent_registered: {
+        account_id: string;
+        agent_uri: string;
+        metadata: string | null;
+        at: string;
+    };
+    agent_updated: RegistryEventData['agent_registered'];
+    feedback_given: Omit<FeedbackView, 'revoked' | 'revoked_at'>;
+    feedback_revoked: Pick<FeedbackView, 'feedback_id' | 'rater' | 'ratee' | 'escrow' | 'payment_id'> & {
+        revoked_at: string;
+    };
+}
+type RegistryEvent = {
+    [K in keyof RegistryEventData]: {
+        standard: 'arras-registry';
+        version: '1.0.0';
+        event: K;
+        data: RegistryEventData[K][];
+    };
+}[keyof RegistryEventData];
+/**
+ * Skip malformed/foreign/unknown logs; preserve valid batches. Raw logs are safe only
+ * when the caller has already filtered receipts by executor_id for the selected network
+ * and successful execution status.
+ * Prefer parseRegistryReceiptEvents for transaction receipts_outcome from the RPC.
+ */
+declare function parseRegistryEvents(logs: readonly unknown[]): RegistryEvent[];
+/** Parse RPC receipts_outcome, accepting only successful receipts from the selected network's registries. */
+declare function parseRegistryReceiptEvents(receiptsOutcome: unknown, net: NearEscrowNetwork): RegistryEvent[];
+type GiveFeedbackOutcome = {
+    status: 'accepted';
+    feedbackId: number;
+} | {
+    status: 'rejected';
+    code: RegistryErrorCode;
+} | {
+    status: 'error';
+    code: RegistryErrorCode;
+    message: string;
+};
+/** Accept a decoded number, {value, logs}, or the final NEAR execution outcome (not a pending send_tx result). */
+declare function parseGiveFeedbackOutcome(outcome: unknown): GiveFeedbackOutcome;
+interface FeedbackSummary {
+    count: number;
+    distinct_raters: number;
+    revoked: number;
+    released_total: string;
+    average_x100: number | null;
+    weighted_average_x100: number | null;
+}
+/**
+ * Summarize the supplied rows for one escrow/operator. Revoked rows only increment revoked.
+ * Active rows count equally in average_x100; released weights weighted_average_x100. Both
+ * use exact bigint sums and floor. No deduplication/pagination: supply each feedback once,
+ * for the intended ratee. Zero total weight returns null, as does an empty active set.
+ */
+declare function summarizeFeedback(feedbacks: readonly FeedbackView[], escrow: string, operatorId: string): FeedbackSummary;
+/** Allow only display links with these schemes; never normalize contract bytes or accept whitespace. */
+declare function safeLink(uri: string): string | null;
+/** Plain text only; remove Unicode control/format characters (including bidi and zero width). Not HTML escaping. */
+declare function displayText(s: string): string;
+
 /**
  * uvd-x402-sdk - NEAR Provider
  *
@@ -382,4 +618,4 @@ declare class NEARProvider implements WalletAdapter {
     private base58Encode;
 }
 
-export { type ArrasAuthorizedData, type ArrasCapsSetData, type ArrasCompactedData, type ArrasEvent, type ArrasEventData, type ArrasOperatorData, type ArrasPauseData, type ArrasPaymentAmountData, type ArrasReleasedData, type ArrasStorageOptions, type ArrasWithdrawnData, type AuthorizeFromBudget, type EscrowAuthorizationOptions, type EscrowMsgParams, NEARProvider, NEAR_ARRAS_STORAGE_DEPOSIT, NEAR_ESCROW_CONTRACTS, NEAR_ESCROW_MAX_GAS, NEAR_ESCROW_MIN_GAS, NEAR_ESCROW_TOKENS, NEAR_USDC_STORAGE_DEPOSIT, type NearEscrowDelegate, type NearEscrowDelegateOptions, type NearEscrowFunctionCall, type NearEscrowLifecycleMethod, type NearEscrowNetwork, type NearEscrowPayment, type NearExactDelegateOptions, type NearExactPayment, type NearLocalSigner, type NearStorageOptions, type NearStorageTransaction, type NearUnsigned, type Nep413Message, type Nep413SignedMessage, type PaymentIdParams, type SignNep413Options, type WalletSelectorOptions, buildArrasStorageDeposit, buildEscrowAuthorizationDelegate, buildEscrowMsg, buildUsdcStorageDeposit, computePaymentId, createNearLocalSigner, NEARProvider as default, nep413Preimage, parseArrasEvents, paymentIdPreimage, reclaim, refund, release, signEscrowAuthorization, signEscrowLifecycle, signExactNearDelegate, signNep413, validateEscrowAuthorizationDelegate, withdraw, withdrawFor };
+export { type AgentView, type ArrasAuthorizedData, type ArrasCapsSetData, type ArrasCompactedData, type ArrasEvent, type ArrasEventData, type ArrasOperatorData, type ArrasPauseData, type ArrasPaymentAmountData, type ArrasReleasedData, type ArrasStorageOptions, type ArrasWithdrawnData, type AuthorizeFromBudget, type EscrowAuthorizationOptions, type EscrowMsgParams, FEEDBACK_DEPOSIT, type FeedbackSummary, type FeedbackView, GIVE_FEEDBACK_GAS, type GiveFeedbackArgs, type GiveFeedbackOutcome, MIN_GIVE_FEEDBACK_GAS, NEARProvider, NEAR_ARRAS_STORAGE_DEPOSIT, NEAR_ESCROW_CONTRACTS, NEAR_ESCROW_MAX_GAS, NEAR_ESCROW_MIN_GAS, NEAR_ESCROW_TOKENS, NEAR_REGISTRY_CONTRACTS, NEAR_REGISTRY_ESCROWS, NEAR_USDC_STORAGE_DEPOSIT, type NearEscrowDelegate, type NearEscrowDelegateOptions, type NearEscrowFunctionCall, type NearEscrowLifecycleMethod, type NearEscrowNetwork, type NearEscrowPayment, type NearExactDelegateOptions, type NearExactPayment, type NearLocalSigner, type NearStorageOptions, type NearStorageTransaction, type NearUnsigned, type Nep413Message, type Nep413SignedMessage, type PaymentIdParams, REGISTER_DEPOSIT, REGISTRY_GAS, type RegistryBuildOptions, type RegistryConfigView, RegistryErrorCode, type RegistryEvent, type RegistryEventData, type RegistryIdentityArgs, type RegistryMethod, type RegistryPage, type RegistryPaymentArgs, type RegistryRpc, type RegistryTarget, type RegistryTransaction, RegistryValidationError, type RegistryViewOptions, type RoleSummaryView, type SignNep413Options, type SummaryView, type WalletSelectorOptions, buildArrasStorageDeposit, buildEscrowAuthorizationDelegate, buildEscrowMsg, buildGiveFeedback, buildRegistryRegister, buildRegistryUpdate, buildRevokeFeedback, buildUsdcStorageDeposit, computePaymentId, createNearLocalSigner, NEARProvider as default, displayText, getAgent, getConfig, getFeedback, getFeedbackForPayment, getSummary, getSummaryByOperator, isFeedbackPending, listAgents, listFeedback, nep413Preimage, parseArrasEvents, parseGiveFeedbackOutcome, parseRegistryEvents, parseRegistryReceiptEvents, paymentIdPreimage, reclaim, refund, release, safeLink, signEscrowAuthorization, signEscrowLifecycle, signExactNearDelegate, signNep413, signRegistryTransaction, summarizeFeedback, validateEscrowAuthorizationDelegate, withdraw, withdrawFor };