X402SettleOutcomeUnknownError
このコンテンツはまだ日本語訳がありません。
Defined in: src/x402/errors.ts:145
A /settle whose outcome is unknown (createHttpFacilitator): something may have
acted on it, and no answer says what happened. That is every thrown settle failure except one
where nothing was ever sent (a refused connection, an unresolved host): a 502 / 503 / 504 (a proxy
can answer 503 after forwarding), a connection dropped after sending, a timeoutMs timeout, a
body that is not a settle response, or a failure answered only after a resend. The transaction
may already be broadcast and may still land.
Do not treat it as a failed payment, and never ask the payer for a new authorization because of
it: reconcile on chain first (the authorization’s nonce is spent once it settles).
createX402Handler answers it with 500 facilitator_settle_outcome_unknown and keeps the
idempotency lease. The underlying failure is cause.
Example
import { X402SettleOutcomeUnknownError } from "kawasekit";
try { await facilitator.settle(request);} catch (error) { if (error instanceof X402SettleOutcomeUnknownError) { // check the authorization's nonce on chain before anything else }}Extends
Error
Constructors
Constructor
new X402SettleOutcomeUnknownError(
cause):X402SettleOutcomeUnknownError
Defined in: src/x402/errors.ts:146
Parameters
cause
Error
Returns
X402SettleOutcomeUnknownError
Overrides
Error.constructor
Properties
cause?
optionalcause?:unknown
Defined in: node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2022.error.d.ts:24
Inherited from
Error.cause
message
message:
string
Defined in: node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es5.d.ts:1075
Inherited from
Error.message
name
name:
string
Defined in: node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es5.d.ts:1074
Inherited from
Error.name
stack?
optionalstack?:string
Defined in: node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es5.d.ts:1076
Inherited from
Error.stack
stackTraceLimit
staticstackTraceLimit:number
Defined in: node_modules/.pnpm/@types+node@22.19.19/node_modules/@types/node/globals.d.ts:68
The Error.stackTraceLimit property specifies the number of stack frames
collected by a stack trace (whether generated by new Error().stack or
Error.captureStackTrace(obj)).
The default value is 10 but may be set to any valid JavaScript number. Changes
will affect any stack trace captured after the value has been changed.
If set to a non-number value, or set to a negative number, stack traces will not capture any frames.
Inherited from
Error.stackTraceLimit
Methods
captureStackTrace()
staticcaptureStackTrace(targetObject,constructorOpt?):void
Defined in: node_modules/.pnpm/@types+node@22.19.19/node_modules/@types/node/globals.d.ts:52
Creates a .stack property on targetObject, which when accessed returns
a string representing the location in the code at which
Error.captureStackTrace() was called.
const myObject = {};Error.captureStackTrace(myObject);myObject.stack; // Similar to `new Error().stack`The first line of the trace will be prefixed with
${myObject.name}: ${myObject.message}.
The optional constructorOpt argument accepts a function. If given, all frames
above constructorOpt, including constructorOpt, will be omitted from the
generated stack trace.
The constructorOpt argument is useful for hiding implementation
details of error generation from the user. For instance:
function a() { b();}
function b() { c();}
function c() { // Create an error without stack trace to avoid calculating the stack trace twice. const { stackTraceLimit } = Error; Error.stackTraceLimit = 0; const error = new Error(); Error.stackTraceLimit = stackTraceLimit;
// Capture the stack trace above function b Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace throw error;}
a();Parameters
targetObject
object
constructorOpt?
Function
Returns
void
Inherited from
Error.captureStackTrace
prepareStackTrace()
staticprepareStackTrace(err,stackTraces):any
Defined in: node_modules/.pnpm/@types+node@22.19.19/node_modules/@types/node/globals.d.ts:56
Parameters
err
Error
stackTraces
CallSite[]
Returns
any
See
https://v8.dev/docs/stack-trace-api#customizing-stack-traces
Inherited from
Error.prepareStackTrace