@lelantos-org/sdk / index / X402PaymentError

Class: X402PaymentError

Defined in: @lelantos-org/sdk/dist/errors/x402.d.ts:24

An x402 payment was refused. Callers branch on reason: budget-exceeded is a policy stop the agent should surface to its operator, while no-acceptable-requirements means this server cannot be paid by this wallet.

Extends

• WalletError<"X402_PAYMENT">

Constructors

Constructor

new X402PaymentError(
   reason, 
   message, 
   opts?
): X402PaymentError;

Defined in: @lelantos-org/sdk/dist/errors/x402.d.ts:28

Parameters

Parameter	Type
reason	X402RefusalReason
message	string
opts?	WalletErrorOptions & object

Returns

X402PaymentError

Overrides

WalletError.constructor

Properties

cause?

optional cause?: unknown;

Defined in: typescript/lib/lib.es2022.error.d.ts:26

Inherited from

WalletError.cause

---

code

readonly code: "X402_PAYMENT";

Defined in: @lelantos-org/sdk/dist/errors/base.d.ts:39

Inherited from

WalletError.code

---

context

readonly context: ErrorContext;

Defined in: @lelantos-org/sdk/dist/errors/base.d.ts:46

Inherited from

WalletError.context

---

details?

readonly optional details?: Readonly<Record<string, string | number | boolean>>;

Defined in: @lelantos-org/sdk/dist/errors/base.d.ts:48

Extra diagnostic scalars for this failure, when any.

Inherited from

WalletError.details

---

message

message: string;

Defined in: typescript/lib/lib.es5.d.ts:1077

Inherited from

WalletError.message

---

name

name: string;

Defined in: typescript/lib/lib.es5.d.ts:1076

Inherited from

WalletError.name

---

reason

readonly reason: X402RefusalReason;

Defined in: @lelantos-org/sdk/dist/errors/x402.d.ts:25

---

resource?

readonly optional resource?: string;

Defined in: @lelantos-org/sdk/dist/errors/x402.d.ts:27

Resource URL the payment was for, when known.

---

retryable

readonly retryable: boolean;

Defined in: @lelantos-org/sdk/dist/errors/base.d.ts:45

Whether the same call, unchanged, may succeed later without user action: a timeout, a 5xx, notes held by an earlier spend. false means retrying as-is will fail the same way.

Inherited from

WalletError.retryable

---

stack?

optional stack?: string;

Defined in: typescript/lib/lib.es5.d.ts:1078

Inherited from

WalletError.stack

Methods

withContext()

withContext(extra): this;

Defined in: @lelantos-org/sdk/dist/errors/base.d.ts:53

Merge additional context in place and return this for rethrowing.

Parameters

Parameter	Type
extra	ErrorContext

Returns

this

Inherited from

WalletError.withContext