@moneytools-dev/x402-guard 0.0.0-stage → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +85 -2
- package/dist/moneytools-x402-guard.d.ts +195 -0
- package/dist/moneytools-x402-guard.d.ts.map +1 -0
- package/dist/moneytools-x402-guard.js +682 -0
- package/dist/moneytools-x402-guard.js.map +1 -0
- package/package.json +54 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 MoneyTools
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,86 @@
|
|
|
1
|
-
|
|
1
|
+
Use this when an agent is about to pay an x402 seller and you want to check the 402 terms, enforce a spend cap (including a daily cumulative budget), optionally ask a human, and keep a payment log — before anything is signed.
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
## Install
|
|
4
|
+
|
|
5
|
+
Install is free.
|
|
6
|
+
|
|
7
|
+
TypeScript:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @moneytools-dev/x402-guard
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Fallback (download):
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
curl -fsSL -o x402-guard.ts https://moneytools.dev/products/payment-safety/examples/x402-guard.ts
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Python (download; PyPI is not published yet):
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
curl -fsSL -o moneytools_x402_guard.py https://moneytools.dev/products/payment-safety/examples/x402-guard.py
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Do not install the unrelated PyPI package named `x402-guard`. The reserved name is `moneytools-x402-guard`.
|
|
26
|
+
|
|
27
|
+
## Three-line example
|
|
28
|
+
|
|
29
|
+
```ts
|
|
30
|
+
import { attachToX402Client } from "@moneytools-dev/x402-guard"; // or from "./x402-guard.ts"
|
|
31
|
+
attachToX402Client(client, { payer: "0xYourAgentWallet", maxUsd: 0.05, dailyMaxUsd: 1, escalate: "high" });
|
|
32
|
+
const paid = wrapFetchWithPayment(fetch, client); // official @x402/fetch — your existing signer stays in charge
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
```python
|
|
36
|
+
from moneytools_x402_guard import attach_to_x402_client
|
|
37
|
+
attach_to_x402_client(client, {"payer": "0xYourAgentWallet", "max_usd": 0.05, "daily_max_usd": 1, "escalate": "high"})
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
If you are not using the official x402 client, wrap the transport *inside* your payment wrapper:
|
|
41
|
+
|
|
42
|
+
```ts
|
|
43
|
+
import { wrapFetch } from "@moneytools-dev/x402-guard"; // or from "./x402-guard.ts"
|
|
44
|
+
const guarded = wrapFetch(fetch, { payer: "0xYourAgentWallet", maxUsd: 0.05, dailyMaxUsd: 1, escalate: "high" });
|
|
45
|
+
const paid = wrapFetchWithPayment(guarded, wallet);
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
```python
|
|
49
|
+
from moneytools_x402_guard import wrap_requests, before_pay
|
|
50
|
+
session = wrap_requests(requests.Session(), {"payer": payer, "max_usd": 0.05, "daily_max_usd": 1})
|
|
51
|
+
# then attach your x402 payment adapter to this session
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
The package never loads a key, never signs, and never sends a payment.
|
|
55
|
+
|
|
56
|
+
## Pricing
|
|
57
|
+
|
|
58
|
+
- **Install:** free.
|
|
59
|
+
- **Checks:** billed per call at **0.005 USDC** via x402 (USDC on Base) after the live free tier. Verified against public docs on 2026-11-13:
|
|
60
|
+
- Pay Precheck `GET https://api.moneytools.dev/v1/precheck` — HTTP 5 free calls/IP/endpoint/UTC day, then 0.005 USDC
|
|
61
|
+
- Settle `POST https://settle.moneytools.dev/v1/spend/check` — trial 50 calls / 7 days (1/client/day), then 0.005 USDC
|
|
62
|
+
- Approval Relay `POST https://relay.moneytools.dev/v1/approvals` — 3 free/day, then 0.005 USDC
|
|
63
|
+
- If a MoneyTools check itself returns HTTP 401/402, the hook **fails closed** and **does not pay MoneyTools automatically**. Pass `apiKey` / `api_key`, or wait for the daily reset.
|
|
64
|
+
- Spend Ledger wallet reports (0.05 USDC, or free with a MoneyTools API key) are not called automatically.
|
|
65
|
+
|
|
66
|
+
## What the hook does
|
|
67
|
+
|
|
68
|
+
1. Skip if the request already has `PAYMENT-SIGNATURE` or `X-PAYMENT` (the payment retry).
|
|
69
|
+
2. Pay Precheck the seller (`block` / `not_402` stop; `warn` stops unless `allowWarn`).
|
|
70
|
+
3. Local `maxUsd` / `max_usd` against the recommended option amount.
|
|
71
|
+
4. Local **daily cumulative budget** (`dailyMaxUsd` / `daily_max_usd`, UTC day, cross-process when a file store is used). Official x402 clients only cap a single payment (default $1).
|
|
72
|
+
5. Settle `POST /v1/spend/check` (advisory; the hook refuses to hand the 402 back to the signer if `allow: false`).
|
|
73
|
+
6. Optional Approval Relay (`escalate`: `off` | `high` | `deny` | `always`). Creates a request and returns `approve_url` / `poll_url`. The hook does not wait or poll.
|
|
74
|
+
7. Append a local **payment log**. After a successful paid request you can also set `recordSpend` / `record_spend` to call Settle `spend/record` — still never auto-pays MoneyTools.
|
|
75
|
+
|
|
76
|
+
Framework guides (Vercel AI SDK, LangChain, Apify mcpc, Coinbase AgentKit, ElizaOS, OpenAI Agents SDK): https://moneytools.dev/products/payment-safety/guides/
|
|
77
|
+
|
|
78
|
+
## Tests (no network, no spending)
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
cd sdk/x402-guard
|
|
82
|
+
npm test
|
|
83
|
+
python3 -m unittest python.test_moneytools_x402_guard
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
MIT © 2026 MoneyTools
|
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MoneyTools x402 payment guard.
|
|
3
|
+
*
|
|
4
|
+
* Use this when an agent is about to pay an x402 seller and you want to
|
|
5
|
+
* check the 402 terms, enforce a spend cap (including a daily cumulative
|
|
6
|
+
* budget), optionally ask a human via Approval Relay, and keep a payment
|
|
7
|
+
* log — before anything is signed.
|
|
8
|
+
*
|
|
9
|
+
* Plug it into any x402 client as a beforePay hook, wrapFetch / wrapAxios
|
|
10
|
+
* (inside your payment wrapper), or attachToX402Client for the official
|
|
11
|
+
* @x402/fetch / x402Client.onBeforePaymentCreation hook (v2.30+).
|
|
12
|
+
*
|
|
13
|
+
* const guarded = wrapFetch(fetch, { payer, maxUsd: 0.05, dailyMaxUsd: 1 });
|
|
14
|
+
* const paid = wrapFetchWithPayment(guarded, wallet);
|
|
15
|
+
* // or:
|
|
16
|
+
* attachToX402Client(client, { payer, maxUsd: 0.05, dailyMaxUsd: 1, escalate: "high" });
|
|
17
|
+
*
|
|
18
|
+
* This file never loads a key, never signs, and never sends a payment.
|
|
19
|
+
*
|
|
20
|
+
* Pricing (install is free). Checks are billed per call via x402 after the
|
|
21
|
+
* live free tier, verified against public docs in Nov 2026:
|
|
22
|
+
* Pay Precheck /v1/precheck — HTTP 5/IP/endpoint/day, then 0.005 USDC
|
|
23
|
+
* Settle /v1/spend/check — trial 50 calls/7 days (1/client/day), then 0.005 USDC
|
|
24
|
+
* Approval Relay /v1/approvals — 3/day, then 0.005 USDC
|
|
25
|
+
* Spend Ledger wallet report — 0.05 USDC (free with a MoneyTools API key); not auto-called
|
|
26
|
+
*
|
|
27
|
+
* Download: https://moneytools.dev/products/payment-safety/examples/x402-guard.ts
|
|
28
|
+
* Package (when published): @moneytools-dev/x402-guard
|
|
29
|
+
*/
|
|
30
|
+
export declare const VERSION = "0.2.1";
|
|
31
|
+
export declare const DEFAULTS: {
|
|
32
|
+
readonly precheckUrl: "https://api.moneytools.dev/v1/precheck";
|
|
33
|
+
readonly spendCheckUrl: "https://settle.moneytools.dev/v1/spend/check";
|
|
34
|
+
readonly spendRecordUrl: "https://settle.moneytools.dev/v1/spend/record";
|
|
35
|
+
readonly relayUrl: "https://relay.moneytools.dev/v1/approvals";
|
|
36
|
+
readonly userAgent: "moneytools-x402-guard/0.2.1";
|
|
37
|
+
};
|
|
38
|
+
export type Risk = "low" | "med" | "high";
|
|
39
|
+
export type Escalate = false | "off" | "high" | "deny" | "always";
|
|
40
|
+
export type BudgetStore = {
|
|
41
|
+
get(key: string): number | Promise<number>;
|
|
42
|
+
add(key: string, amount: number): number | Promise<number>;
|
|
43
|
+
};
|
|
44
|
+
export type PaymentLogEntry = {
|
|
45
|
+
ts: string;
|
|
46
|
+
event: "decision" | "payload_created" | "paid" | "record_failed";
|
|
47
|
+
payer?: string;
|
|
48
|
+
sellerUrl?: string;
|
|
49
|
+
host?: string;
|
|
50
|
+
payTo?: string;
|
|
51
|
+
amountUsd?: string;
|
|
52
|
+
proceed?: boolean;
|
|
53
|
+
step?: string;
|
|
54
|
+
reason?: string;
|
|
55
|
+
};
|
|
56
|
+
export type PaymentLog = {
|
|
57
|
+
append(entry: PaymentLogEntry): void | Promise<void>;
|
|
58
|
+
list(): PaymentLogEntry[] | Promise<PaymentLogEntry[]>;
|
|
59
|
+
};
|
|
60
|
+
export type GuardConfig = {
|
|
61
|
+
payer?: string;
|
|
62
|
+
maxUsd?: number;
|
|
63
|
+
/** Cross-process UTC-day cumulative cap in USDC (on top of per-payment maxUsd). */
|
|
64
|
+
dailyMaxUsd?: number;
|
|
65
|
+
budgetStore?: BudgetStore;
|
|
66
|
+
budgetPath?: string;
|
|
67
|
+
allowWarn?: boolean;
|
|
68
|
+
precheck?: boolean;
|
|
69
|
+
spendCheck?: boolean;
|
|
70
|
+
reserve?: boolean;
|
|
71
|
+
sessionId?: string;
|
|
72
|
+
risk?: Risk;
|
|
73
|
+
escalate?: Escalate;
|
|
74
|
+
apiKey?: string;
|
|
75
|
+
precheckUrl?: string;
|
|
76
|
+
spendCheckUrl?: string;
|
|
77
|
+
spendRecordUrl?: string;
|
|
78
|
+
relayUrl?: string;
|
|
79
|
+
userAgent?: string;
|
|
80
|
+
headers?: Record<string, string>;
|
|
81
|
+
/** Fetch used only for MoneyTools APIs (never the wrapped client). */
|
|
82
|
+
mtFetch?: typeof fetch;
|
|
83
|
+
/** fail closed unless set to "allow". */
|
|
84
|
+
onPrecheckError?: "deny" | "allow";
|
|
85
|
+
/** Local payment log (default on, in-memory; set logPath for a JSONL file). */
|
|
86
|
+
logPayments?: boolean;
|
|
87
|
+
paymentLog?: PaymentLog;
|
|
88
|
+
logPath?: string;
|
|
89
|
+
/** After a successful paid request, POST Settle /v1/spend/record. Never auto-pays. Default off. */
|
|
90
|
+
recordSpend?: boolean;
|
|
91
|
+
/** Decimals for official-hook atomic amounts. Default: 6 for USDC-like assets. */
|
|
92
|
+
assetDecimals?: number;
|
|
93
|
+
};
|
|
94
|
+
export type BeforePayInput = {
|
|
95
|
+
sellerUrl: string;
|
|
96
|
+
method?: string;
|
|
97
|
+
paymentRequired?: string;
|
|
98
|
+
amountUsd?: string | number;
|
|
99
|
+
host?: string;
|
|
100
|
+
payTo?: string;
|
|
101
|
+
network?: string;
|
|
102
|
+
risk?: Risk;
|
|
103
|
+
asset?: string;
|
|
104
|
+
};
|
|
105
|
+
export type BeforePayOk = {
|
|
106
|
+
proceed: true;
|
|
107
|
+
step: "ok";
|
|
108
|
+
amountUsd?: string;
|
|
109
|
+
host?: string;
|
|
110
|
+
payTo?: string;
|
|
111
|
+
pre?: unknown;
|
|
112
|
+
cap?: unknown;
|
|
113
|
+
};
|
|
114
|
+
export type BeforePayBlocked = {
|
|
115
|
+
proceed: false;
|
|
116
|
+
step: "precheck" | "spend_check" | "budget" | "approval_relay" | "upstream";
|
|
117
|
+
reason: string;
|
|
118
|
+
pre?: unknown;
|
|
119
|
+
cap?: unknown;
|
|
120
|
+
approval?: {
|
|
121
|
+
approval_id?: string;
|
|
122
|
+
approve_url?: string;
|
|
123
|
+
poll_url?: string;
|
|
124
|
+
status?: string;
|
|
125
|
+
};
|
|
126
|
+
};
|
|
127
|
+
export type BeforePayResult = BeforePayOk | BeforePayBlocked;
|
|
128
|
+
export declare class PaymentBlockedError extends Error {
|
|
129
|
+
readonly result: BeforePayBlocked;
|
|
130
|
+
constructor(result: BeforePayBlocked);
|
|
131
|
+
}
|
|
132
|
+
export declare class MoneyToolsApiError extends Error {
|
|
133
|
+
readonly status: number;
|
|
134
|
+
readonly body: unknown;
|
|
135
|
+
constructor(status: number, message: string, body?: unknown);
|
|
136
|
+
}
|
|
137
|
+
export declare function hasPaymentHeader(headers: Headers | Record<string, unknown> | undefined | null): boolean;
|
|
138
|
+
export declare function hostOf(url: string): string | undefined;
|
|
139
|
+
export declare function pickAmountUsd(pre: any, fallback?: string | number): string | undefined;
|
|
140
|
+
export declare function utcDay(d?: Date): string;
|
|
141
|
+
export declare function budgetKey(payer?: string, day?: string): string;
|
|
142
|
+
export declare function inferAssetDecimals(asset?: string, _network?: string): number;
|
|
143
|
+
/** Convert an official-hook requirement (atomic string or decimal) to a USDC decimal string. */
|
|
144
|
+
export declare function amountToUsd(req: any, decimals?: number): string | undefined;
|
|
145
|
+
export declare function sellerUrlFromContext(ctx: any): string;
|
|
146
|
+
export declare function encodePaymentRequired(pr: unknown): string | undefined;
|
|
147
|
+
export declare function memoryBudgetStore(): BudgetStore;
|
|
148
|
+
export declare function memoryPaymentLog(): PaymentLog;
|
|
149
|
+
export declare function fileBudgetStore(path: string): BudgetStore;
|
|
150
|
+
export declare function filePaymentLog(path: string): PaymentLog;
|
|
151
|
+
export declare function getPaymentLog(cfg?: GuardConfig): PaymentLog;
|
|
152
|
+
export declare function beforePay(input: BeforePayInput, cfg?: GuardConfig): Promise<BeforePayResult>;
|
|
153
|
+
export declare function assertAllowed(input: BeforePayInput, cfg: GuardConfig): Promise<BeforePayOk>;
|
|
154
|
+
export type PaymentCreationContextLike = {
|
|
155
|
+
paymentRequired?: any;
|
|
156
|
+
selectedRequirements?: any;
|
|
157
|
+
payment_required?: any;
|
|
158
|
+
selected_requirements?: any;
|
|
159
|
+
};
|
|
160
|
+
export type BeforePaymentCreationHook = (context: PaymentCreationContextLike) => Promise<void | {
|
|
161
|
+
abort: true;
|
|
162
|
+
reason: string;
|
|
163
|
+
}>;
|
|
164
|
+
export declare function inputFromPaymentContext(ctx: PaymentCreationContextLike, cfg?: GuardConfig): BeforePayInput;
|
|
165
|
+
/** Official x402 client hook: return { abort: true, reason } to stop signing. */
|
|
166
|
+
export declare function createBeforePaymentCreationHook(cfg: GuardConfig): BeforePaymentCreationHook;
|
|
167
|
+
export declare function createAfterPaymentCreationHook(cfg: GuardConfig): (ctx: PaymentCreationContextLike & {
|
|
168
|
+
paymentPayload?: unknown;
|
|
169
|
+
payment_payload?: unknown;
|
|
170
|
+
}) => Promise<void>;
|
|
171
|
+
export declare function createPaymentResponseHook(cfg: GuardConfig): (ctx: any) => Promise<void>;
|
|
172
|
+
/** Duck-typed adapter for x402Client / @x402/fetch (v2.30+). Does not import @x402/core. */
|
|
173
|
+
export declare function attachToX402Client<T extends {
|
|
174
|
+
onBeforePaymentCreation?: (hook: any) => any;
|
|
175
|
+
on_before_payment_creation?: (hook: any) => any;
|
|
176
|
+
onAfterPaymentCreation?: (hook: any) => any;
|
|
177
|
+
on_after_payment_creation?: (hook: any) => any;
|
|
178
|
+
onPaymentResponse?: (hook: any) => any;
|
|
179
|
+
on_payment_response?: (hook: any) => any;
|
|
180
|
+
}>(client: T, cfg: GuardConfig): T;
|
|
181
|
+
export declare function postSpendRecord(cfg: GuardConfig, input: BeforePayInput): Promise<unknown>;
|
|
182
|
+
export declare function wrapFetch(baseFetch: typeof fetch, cfg: GuardConfig): typeof fetch;
|
|
183
|
+
/**
|
|
184
|
+
* Axios response interceptor, unshifted so it runs before a payment adapter.
|
|
185
|
+
* Prefer composing like wrapFetch: payment wrapper outside, this inside.
|
|
186
|
+
*/
|
|
187
|
+
export declare function wrapAxios<T extends {
|
|
188
|
+
interceptors: {
|
|
189
|
+
response: {
|
|
190
|
+
use: Function;
|
|
191
|
+
handlers?: any[];
|
|
192
|
+
};
|
|
193
|
+
};
|
|
194
|
+
}>(instance: T, cfg: GuardConfig): T;
|
|
195
|
+
//# sourceMappingURL=moneytools-x402-guard.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"moneytools-x402-guard.d.ts","sourceRoot":"","sources":["../ts/moneytools-x402-guard.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,682 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MoneyTools x402 payment guard.
|
|
3
|
+
*
|
|
4
|
+
* Use this when an agent is about to pay an x402 seller and you want to
|
|
5
|
+
* check the 402 terms, enforce a spend cap (including a daily cumulative
|
|
6
|
+
* budget), optionally ask a human via Approval Relay, and keep a payment
|
|
7
|
+
* log — before anything is signed.
|
|
8
|
+
*
|
|
9
|
+
* Plug it into any x402 client as a beforePay hook, wrapFetch / wrapAxios
|
|
10
|
+
* (inside your payment wrapper), or attachToX402Client for the official
|
|
11
|
+
* @x402/fetch / x402Client.onBeforePaymentCreation hook (v2.30+).
|
|
12
|
+
*
|
|
13
|
+
* const guarded = wrapFetch(fetch, { payer, maxUsd: 0.05, dailyMaxUsd: 1 });
|
|
14
|
+
* const paid = wrapFetchWithPayment(guarded, wallet);
|
|
15
|
+
* // or:
|
|
16
|
+
* attachToX402Client(client, { payer, maxUsd: 0.05, dailyMaxUsd: 1, escalate: "high" });
|
|
17
|
+
*
|
|
18
|
+
* This file never loads a key, never signs, and never sends a payment.
|
|
19
|
+
*
|
|
20
|
+
* Pricing (install is free). Checks are billed per call via x402 after the
|
|
21
|
+
* live free tier, verified against public docs in Nov 2026:
|
|
22
|
+
* Pay Precheck /v1/precheck — HTTP 5/IP/endpoint/day, then 0.005 USDC
|
|
23
|
+
* Settle /v1/spend/check — trial 50 calls/7 days (1/client/day), then 0.005 USDC
|
|
24
|
+
* Approval Relay /v1/approvals — 3/day, then 0.005 USDC
|
|
25
|
+
* Spend Ledger wallet report — 0.05 USDC (free with a MoneyTools API key); not auto-called
|
|
26
|
+
*
|
|
27
|
+
* Download: https://moneytools.dev/products/payment-safety/examples/x402-guard.ts
|
|
28
|
+
* Package (when published): @moneytools-dev/x402-guard
|
|
29
|
+
*/
|
|
30
|
+
export const VERSION = "0.2.1";
|
|
31
|
+
export const DEFAULTS = {
|
|
32
|
+
precheckUrl: "https://api.moneytools.dev/v1/precheck",
|
|
33
|
+
spendCheckUrl: "https://settle.moneytools.dev/v1/spend/check",
|
|
34
|
+
spendRecordUrl: "https://settle.moneytools.dev/v1/spend/record",
|
|
35
|
+
relayUrl: "https://relay.moneytools.dev/v1/approvals",
|
|
36
|
+
userAgent: `moneytools-x402-guard/${VERSION}`,
|
|
37
|
+
};
|
|
38
|
+
export class PaymentBlockedError extends Error {
|
|
39
|
+
result;
|
|
40
|
+
constructor(result) {
|
|
41
|
+
super(result.reason);
|
|
42
|
+
this.name = "PaymentBlockedError";
|
|
43
|
+
this.result = result;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
export class MoneyToolsApiError extends Error {
|
|
47
|
+
status;
|
|
48
|
+
body;
|
|
49
|
+
constructor(status, message, body) {
|
|
50
|
+
super(message);
|
|
51
|
+
this.name = "MoneyToolsApiError";
|
|
52
|
+
this.status = status;
|
|
53
|
+
this.body = body;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
const PAYMENT_HDRS = ["payment-signature", "payment-signature-header", "x-payment"];
|
|
57
|
+
const defaultMemoryBudget = memoryBudgetStore();
|
|
58
|
+
const defaultMemoryLog = memoryPaymentLog();
|
|
59
|
+
export function hasPaymentHeader(headers) {
|
|
60
|
+
if (!headers)
|
|
61
|
+
return false;
|
|
62
|
+
const get = (name) => {
|
|
63
|
+
if (typeof headers.get === "function")
|
|
64
|
+
return headers.get(name);
|
|
65
|
+
const h = headers;
|
|
66
|
+
for (const [k, v] of Object.entries(h))
|
|
67
|
+
if (k.toLowerCase() === name.toLowerCase())
|
|
68
|
+
return v == null ? null : String(v);
|
|
69
|
+
return null;
|
|
70
|
+
};
|
|
71
|
+
return PAYMENT_HDRS.some((n) => {
|
|
72
|
+
const v = get(n);
|
|
73
|
+
return typeof v === "string" && v.trim().length > 0;
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
export function hostOf(url) {
|
|
77
|
+
try {
|
|
78
|
+
return new URL(url).hostname.toLowerCase();
|
|
79
|
+
}
|
|
80
|
+
catch {
|
|
81
|
+
return undefined;
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
export function pickAmountUsd(pre, fallback) {
|
|
85
|
+
const recIdx = pre?.recommendedOption;
|
|
86
|
+
const options = Array.isArray(pre?.options) ? pre.options : [];
|
|
87
|
+
const rec = typeof recIdx === "number" ? options[recIdx] : null;
|
|
88
|
+
const valid = options.filter((o) => o && o.valid && !o?.sanctions?.hit);
|
|
89
|
+
const hit = rec && rec.valid && !rec?.sanctions?.hit ? rec : valid[0];
|
|
90
|
+
const raw = hit?.amountUsd ?? fallback;
|
|
91
|
+
if (raw == null || raw === "")
|
|
92
|
+
return undefined;
|
|
93
|
+
return String(raw);
|
|
94
|
+
}
|
|
95
|
+
export function utcDay(d = new Date()) {
|
|
96
|
+
return d.toISOString().slice(0, 10);
|
|
97
|
+
}
|
|
98
|
+
export function budgetKey(payer, day) {
|
|
99
|
+
return `${(payer || "anon").toLowerCase()}:${day || utcDay()}`;
|
|
100
|
+
}
|
|
101
|
+
export function inferAssetDecimals(asset, _network) {
|
|
102
|
+
if (!asset)
|
|
103
|
+
return 6;
|
|
104
|
+
const a = asset.toLowerCase();
|
|
105
|
+
if (a === "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913")
|
|
106
|
+
return 6;
|
|
107
|
+
if (a === "eth" || a.endsWith("-native") || a.includes("ether"))
|
|
108
|
+
return 18;
|
|
109
|
+
if (a.includes("usdc") || a.includes("usdt") || a.includes("dai"))
|
|
110
|
+
return 6;
|
|
111
|
+
return 6;
|
|
112
|
+
}
|
|
113
|
+
/** Convert an official-hook requirement (atomic string or decimal) to a USDC decimal string. */
|
|
114
|
+
export function amountToUsd(req, decimals) {
|
|
115
|
+
if (req == null)
|
|
116
|
+
return undefined;
|
|
117
|
+
const raw = req.amountUsd ?? req.amount_usd ?? req.amount ?? req.maxAmountRequired ?? req.max_amount_required;
|
|
118
|
+
if (raw == null || raw === "")
|
|
119
|
+
return undefined;
|
|
120
|
+
const s = String(raw);
|
|
121
|
+
if (s.includes("."))
|
|
122
|
+
return s;
|
|
123
|
+
if (!/^\d+$/.test(s))
|
|
124
|
+
return s;
|
|
125
|
+
const d = decimals ?? inferAssetDecimals(req.asset, req.network ?? req.networkId);
|
|
126
|
+
const n = Number(s) / 10 ** d;
|
|
127
|
+
if (!Number.isFinite(n))
|
|
128
|
+
return undefined;
|
|
129
|
+
return String(Number(n.toFixed(d)));
|
|
130
|
+
}
|
|
131
|
+
export function sellerUrlFromContext(ctx) {
|
|
132
|
+
const pr = ctx?.paymentRequired ?? ctx?.payment_required ?? {};
|
|
133
|
+
const sel = ctx?.selectedRequirements ?? ctx?.selected_requirements ?? {};
|
|
134
|
+
const resource = pr.resource ?? sel.resource;
|
|
135
|
+
if (resource && typeof resource === "object" && resource.url)
|
|
136
|
+
return String(resource.url);
|
|
137
|
+
if (typeof resource === "string" && resource)
|
|
138
|
+
return resource;
|
|
139
|
+
return "";
|
|
140
|
+
}
|
|
141
|
+
export function encodePaymentRequired(pr) {
|
|
142
|
+
if (pr == null)
|
|
143
|
+
return undefined;
|
|
144
|
+
if (typeof pr === "string")
|
|
145
|
+
return pr;
|
|
146
|
+
try {
|
|
147
|
+
return JSON.stringify(pr);
|
|
148
|
+
}
|
|
149
|
+
catch {
|
|
150
|
+
return undefined;
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
export function memoryBudgetStore() {
|
|
154
|
+
const m = new Map();
|
|
155
|
+
return {
|
|
156
|
+
get(key) { return m.get(key) || 0; },
|
|
157
|
+
add(key, amount) {
|
|
158
|
+
const next = (m.get(key) || 0) + amount;
|
|
159
|
+
m.set(key, next);
|
|
160
|
+
return next;
|
|
161
|
+
},
|
|
162
|
+
};
|
|
163
|
+
}
|
|
164
|
+
export function memoryPaymentLog() {
|
|
165
|
+
const rows = [];
|
|
166
|
+
return {
|
|
167
|
+
append(entry) { rows.push(entry); },
|
|
168
|
+
list() { return rows.slice(); },
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
function canUseNodeFs() {
|
|
172
|
+
return typeof process !== "undefined" && !!process.versions?.node;
|
|
173
|
+
}
|
|
174
|
+
function defaultDataPath(name) {
|
|
175
|
+
const home = (typeof process !== "undefined" && (process.env.HOME || process.env.USERPROFILE)) || ".";
|
|
176
|
+
return `${home}/.moneytools/${name}`;
|
|
177
|
+
}
|
|
178
|
+
async function nodeFs() {
|
|
179
|
+
if (!canUseNodeFs())
|
|
180
|
+
return null;
|
|
181
|
+
return await import("node:fs/promises");
|
|
182
|
+
}
|
|
183
|
+
async function readJsonFile(path, fallback) {
|
|
184
|
+
const fs = await nodeFs();
|
|
185
|
+
if (!fs)
|
|
186
|
+
return fallback;
|
|
187
|
+
try {
|
|
188
|
+
return JSON.parse(await fs.readFile(path, "utf8"));
|
|
189
|
+
}
|
|
190
|
+
catch {
|
|
191
|
+
return fallback;
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
async function writeJsonFile(path, data) {
|
|
195
|
+
const fs = await nodeFs();
|
|
196
|
+
if (!fs)
|
|
197
|
+
return;
|
|
198
|
+
const { dirname } = await import("node:path");
|
|
199
|
+
await fs.mkdir(dirname(path), { recursive: true });
|
|
200
|
+
const tmp = `${path}.tmp`;
|
|
201
|
+
await fs.writeFile(tmp, JSON.stringify(data, null, 2));
|
|
202
|
+
await fs.rename(tmp, path);
|
|
203
|
+
}
|
|
204
|
+
export function fileBudgetStore(path) {
|
|
205
|
+
return {
|
|
206
|
+
async get(key) {
|
|
207
|
+
const data = await readJsonFile(path, {});
|
|
208
|
+
return Number(data[key] || 0);
|
|
209
|
+
},
|
|
210
|
+
async add(key, amount) {
|
|
211
|
+
const data = await readJsonFile(path, {});
|
|
212
|
+
const next = Number(data[key] || 0) + amount;
|
|
213
|
+
data[key] = next;
|
|
214
|
+
await writeJsonFile(path, data);
|
|
215
|
+
return next;
|
|
216
|
+
},
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
export function filePaymentLog(path) {
|
|
220
|
+
const cache = [];
|
|
221
|
+
let loaded = false;
|
|
222
|
+
async function load() {
|
|
223
|
+
if (loaded)
|
|
224
|
+
return;
|
|
225
|
+
const fs = await nodeFs();
|
|
226
|
+
if (fs) {
|
|
227
|
+
try {
|
|
228
|
+
const text = await fs.readFile(path, "utf8");
|
|
229
|
+
for (const line of text.split("\n")) {
|
|
230
|
+
if (!line.trim())
|
|
231
|
+
continue;
|
|
232
|
+
try {
|
|
233
|
+
cache.push(JSON.parse(line));
|
|
234
|
+
}
|
|
235
|
+
catch { /* skip bad line */ }
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
catch { /* missing file */ }
|
|
239
|
+
}
|
|
240
|
+
loaded = true;
|
|
241
|
+
}
|
|
242
|
+
return {
|
|
243
|
+
async append(entry) {
|
|
244
|
+
await load();
|
|
245
|
+
cache.push(entry);
|
|
246
|
+
const fs = await nodeFs();
|
|
247
|
+
if (!fs)
|
|
248
|
+
return;
|
|
249
|
+
const { dirname } = await import("node:path");
|
|
250
|
+
await fs.mkdir(dirname(path), { recursive: true });
|
|
251
|
+
await fs.appendFile(path, JSON.stringify(entry) + "\n");
|
|
252
|
+
},
|
|
253
|
+
async list() {
|
|
254
|
+
await load();
|
|
255
|
+
return cache.slice();
|
|
256
|
+
},
|
|
257
|
+
};
|
|
258
|
+
}
|
|
259
|
+
function resolveBudgetStore(cfg) {
|
|
260
|
+
if (cfg.dailyMaxUsd == null)
|
|
261
|
+
return undefined;
|
|
262
|
+
if (cfg.budgetStore)
|
|
263
|
+
return cfg.budgetStore;
|
|
264
|
+
if (cfg.budgetPath)
|
|
265
|
+
return fileBudgetStore(cfg.budgetPath);
|
|
266
|
+
if (canUseNodeFs())
|
|
267
|
+
return fileBudgetStore(defaultDataPath("x402-guard-budget.json"));
|
|
268
|
+
return defaultMemoryBudget;
|
|
269
|
+
}
|
|
270
|
+
function resolvePaymentLog(cfg) {
|
|
271
|
+
if (cfg.logPayments === false)
|
|
272
|
+
return undefined;
|
|
273
|
+
if (cfg.paymentLog)
|
|
274
|
+
return cfg.paymentLog;
|
|
275
|
+
if (cfg.logPath)
|
|
276
|
+
return filePaymentLog(cfg.logPath);
|
|
277
|
+
return defaultMemoryLog;
|
|
278
|
+
}
|
|
279
|
+
export function getPaymentLog(cfg = {}) {
|
|
280
|
+
return resolvePaymentLog({ logPayments: true, ...cfg }) ?? defaultMemoryLog;
|
|
281
|
+
}
|
|
282
|
+
async function appendLog(cfg, entry) {
|
|
283
|
+
const log = resolvePaymentLog(cfg);
|
|
284
|
+
if (!log)
|
|
285
|
+
return;
|
|
286
|
+
await log.append({ ts: entry.ts ?? new Date().toISOString(), ...entry });
|
|
287
|
+
}
|
|
288
|
+
function requestUrl(input) {
|
|
289
|
+
if (typeof input === "string")
|
|
290
|
+
return input;
|
|
291
|
+
if (input instanceof URL)
|
|
292
|
+
return input.href;
|
|
293
|
+
return input.url;
|
|
294
|
+
}
|
|
295
|
+
function mergeHeaders(input, init) {
|
|
296
|
+
const h = new Headers(init?.headers);
|
|
297
|
+
if (typeof Request !== "undefined" && input instanceof Request) {
|
|
298
|
+
input.headers.forEach((v, k) => { if (!h.has(k))
|
|
299
|
+
h.set(k, v); });
|
|
300
|
+
}
|
|
301
|
+
return h;
|
|
302
|
+
}
|
|
303
|
+
async function mtCall(cfg, url, init = {}) {
|
|
304
|
+
const fetchImpl = cfg.mtFetch ?? fetch;
|
|
305
|
+
const headers = new Headers(init.headers);
|
|
306
|
+
if (!headers.has("user-agent"))
|
|
307
|
+
headers.set("user-agent", cfg.userAgent ?? DEFAULTS.userAgent);
|
|
308
|
+
if (!headers.has("accept"))
|
|
309
|
+
headers.set("accept", "application/json");
|
|
310
|
+
if (cfg.apiKey && !headers.has("x-api-key"))
|
|
311
|
+
headers.set("x-api-key", cfg.apiKey);
|
|
312
|
+
if (cfg.headers)
|
|
313
|
+
for (const [k, v] of Object.entries(cfg.headers))
|
|
314
|
+
if (!headers.has(k))
|
|
315
|
+
headers.set(k, v);
|
|
316
|
+
const res = await fetchImpl(url, { ...init, headers });
|
|
317
|
+
const text = await res.text();
|
|
318
|
+
let body = text;
|
|
319
|
+
try {
|
|
320
|
+
body = text ? JSON.parse(text) : null;
|
|
321
|
+
}
|
|
322
|
+
catch { /* keep text */ }
|
|
323
|
+
if (res.status === 402 || res.status === 401) {
|
|
324
|
+
throw new MoneyToolsApiError(res.status, `MoneyTools API ${url} returned HTTP ${res.status} (free tier exhausted or key required; pass apiKey or wait for the daily reset). This guard does not pay MoneyTools automatically.`, body);
|
|
325
|
+
}
|
|
326
|
+
if (!res.ok) {
|
|
327
|
+
throw new MoneyToolsApiError(res.status, `MoneyTools API ${url} returned HTTP ${res.status}`, body);
|
|
328
|
+
}
|
|
329
|
+
return body;
|
|
330
|
+
}
|
|
331
|
+
function shouldEscalate(cfg, input, capDenied) {
|
|
332
|
+
const mode = cfg.escalate ?? "off";
|
|
333
|
+
if (!mode || mode === "off")
|
|
334
|
+
return false;
|
|
335
|
+
if (mode === "always")
|
|
336
|
+
return true;
|
|
337
|
+
if (mode === "deny" && capDenied)
|
|
338
|
+
return true;
|
|
339
|
+
if (mode === "high" && (input.risk ?? cfg.risk) === "high")
|
|
340
|
+
return true;
|
|
341
|
+
return false;
|
|
342
|
+
}
|
|
343
|
+
async function maybeRelay(cfg, input, reason) {
|
|
344
|
+
const amount = input.amountUsd != null ? String(input.amountUsd) : "?";
|
|
345
|
+
const host = input.host ?? hostOf(input.sellerUrl) ?? "unknown host";
|
|
346
|
+
const body = {
|
|
347
|
+
action_summary: `Pay ${amount} USDC to ${host} at ${input.sellerUrl}`.slice(0, 500),
|
|
348
|
+
risk: input.risk ?? cfg.risk ?? "med",
|
|
349
|
+
expires_in_s: 3600,
|
|
350
|
+
};
|
|
351
|
+
try {
|
|
352
|
+
const appr = await mtCall(cfg, cfg.relayUrl ?? DEFAULTS.relayUrl, {
|
|
353
|
+
method: "POST",
|
|
354
|
+
headers: { "content-type": "application/json" },
|
|
355
|
+
body: JSON.stringify(body),
|
|
356
|
+
});
|
|
357
|
+
return {
|
|
358
|
+
proceed: false,
|
|
359
|
+
step: "approval_relay",
|
|
360
|
+
reason,
|
|
361
|
+
approval: {
|
|
362
|
+
approval_id: appr?.approval_id,
|
|
363
|
+
approve_url: appr?.approve_url,
|
|
364
|
+
poll_url: appr?.poll_url,
|
|
365
|
+
status: appr?.status,
|
|
366
|
+
},
|
|
367
|
+
};
|
|
368
|
+
}
|
|
369
|
+
catch (err) {
|
|
370
|
+
return {
|
|
371
|
+
proceed: false,
|
|
372
|
+
step: "approval_relay",
|
|
373
|
+
reason: `${reason} (Approval Relay failed: ${err instanceof Error ? err.message : String(err)})`,
|
|
374
|
+
};
|
|
375
|
+
}
|
|
376
|
+
}
|
|
377
|
+
export async function beforePay(input, cfg = {}) {
|
|
378
|
+
const host = input.host ?? hostOf(input.sellerUrl);
|
|
379
|
+
const doPre = cfg.precheck !== false;
|
|
380
|
+
const doCap = cfg.spendCheck !== false;
|
|
381
|
+
let pre;
|
|
382
|
+
if (doPre) {
|
|
383
|
+
try {
|
|
384
|
+
const u = new URL(cfg.precheckUrl ?? DEFAULTS.precheckUrl);
|
|
385
|
+
u.searchParams.set("url", input.sellerUrl);
|
|
386
|
+
u.searchParams.set("method", (input.method || "GET").toUpperCase());
|
|
387
|
+
pre = await mtCall(cfg, u.toString());
|
|
388
|
+
}
|
|
389
|
+
catch (err) {
|
|
390
|
+
if (err instanceof MoneyToolsApiError) {
|
|
391
|
+
const blocked = { proceed: false, step: "upstream", reason: err.message };
|
|
392
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, proceed: false, step: "upstream", reason: err.message });
|
|
393
|
+
return blocked;
|
|
394
|
+
}
|
|
395
|
+
if (cfg.onPrecheckError === "allow") {
|
|
396
|
+
/* fall through to spend check / local budget */
|
|
397
|
+
}
|
|
398
|
+
else {
|
|
399
|
+
const reason = `precheck failed (fail closed): ${err instanceof Error ? err.message : String(err)}`;
|
|
400
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, proceed: false, step: "precheck", reason });
|
|
401
|
+
return { proceed: false, step: "precheck", reason };
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
if (pre) {
|
|
405
|
+
const verdict = pre.verdict;
|
|
406
|
+
if (verdict === "block" || pre.ok === false || verdict === "not_402") {
|
|
407
|
+
const reason = pre.summary || `precheck verdict=${verdict}`;
|
|
408
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, proceed: false, step: "precheck", reason });
|
|
409
|
+
return { proceed: false, step: "precheck", reason, pre };
|
|
410
|
+
}
|
|
411
|
+
if (verdict === "warn" && !cfg.allowWarn) {
|
|
412
|
+
const reason = pre.summary || "precheck verdict=warn (set allowWarn to proceed)";
|
|
413
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, proceed: false, step: "precheck", reason });
|
|
414
|
+
return { proceed: false, step: "precheck", reason, pre };
|
|
415
|
+
}
|
|
416
|
+
}
|
|
417
|
+
}
|
|
418
|
+
const amountUsd = pickAmountUsd(pre, input.amountUsd);
|
|
419
|
+
const payTo = input.payTo ?? pre?.options?.find((o) => o?.valid && !o?.sanctions?.hit)?.payTo;
|
|
420
|
+
const scoped = { ...input, amountUsd, host, payTo };
|
|
421
|
+
const blockBudget = async (reason, cap) => {
|
|
422
|
+
const blocked = { proceed: false, step: "budget", reason, pre, cap };
|
|
423
|
+
if (shouldEscalate(cfg, scoped, false)) {
|
|
424
|
+
const relayed = await maybeRelay(cfg, scoped, reason);
|
|
425
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, payTo, amountUsd, proceed: false, step: "approval_relay", reason });
|
|
426
|
+
return relayed;
|
|
427
|
+
}
|
|
428
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, payTo, amountUsd, proceed: false, step: "budget", reason });
|
|
429
|
+
return blocked;
|
|
430
|
+
};
|
|
431
|
+
if (cfg.maxUsd != null && amountUsd != null && Number(amountUsd) > cfg.maxUsd) {
|
|
432
|
+
return blockBudget(`amount ${amountUsd} USDC exceeds local maxUsd ${cfg.maxUsd}`);
|
|
433
|
+
}
|
|
434
|
+
const store = resolveBudgetStore(cfg);
|
|
435
|
+
if (store && cfg.dailyMaxUsd != null && amountUsd != null) {
|
|
436
|
+
const key = budgetKey(cfg.payer);
|
|
437
|
+
const spent = await store.get(key);
|
|
438
|
+
if (spent + Number(amountUsd) > cfg.dailyMaxUsd) {
|
|
439
|
+
return blockBudget(`amount ${amountUsd} USDC would exceed dailyMaxUsd ${cfg.dailyMaxUsd} (spent ${spent} today UTC)`);
|
|
440
|
+
}
|
|
441
|
+
}
|
|
442
|
+
let cap;
|
|
443
|
+
if (doCap) {
|
|
444
|
+
if (!cfg.payer) {
|
|
445
|
+
const reason = "spendCheck is on but cfg.payer is missing";
|
|
446
|
+
await appendLog(cfg, { event: "decision", sellerUrl: input.sellerUrl, host, proceed: false, step: "spend_check", reason });
|
|
447
|
+
return { proceed: false, step: "spend_check", reason, pre };
|
|
448
|
+
}
|
|
449
|
+
cap = await mtCall(cfg, cfg.spendCheckUrl ?? DEFAULTS.spendCheckUrl, {
|
|
450
|
+
method: "POST",
|
|
451
|
+
headers: { "content-type": "application/json" },
|
|
452
|
+
body: JSON.stringify({
|
|
453
|
+
payer: cfg.payer,
|
|
454
|
+
paymentRequired: input.paymentRequired,
|
|
455
|
+
amountUsd,
|
|
456
|
+
payTo,
|
|
457
|
+
host,
|
|
458
|
+
network: input.network,
|
|
459
|
+
sessionId: cfg.sessionId,
|
|
460
|
+
reserve: cfg.reserve === true,
|
|
461
|
+
}),
|
|
462
|
+
});
|
|
463
|
+
if (cap?.allow === false) {
|
|
464
|
+
const reason = Array.isArray(cap.reasons) && cap.reasons[0]
|
|
465
|
+
? (cap.reasons[0].message || cap.reasons[0].code || "spend cap denied")
|
|
466
|
+
: "spend cap denied";
|
|
467
|
+
if (shouldEscalate(cfg, scoped, true)) {
|
|
468
|
+
const relayed = await maybeRelay(cfg, scoped, reason);
|
|
469
|
+
relayed.pre = pre;
|
|
470
|
+
relayed.cap = cap;
|
|
471
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, payTo, amountUsd, proceed: false, step: "approval_relay", reason });
|
|
472
|
+
return relayed;
|
|
473
|
+
}
|
|
474
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, payTo, amountUsd, proceed: false, step: "spend_check", reason });
|
|
475
|
+
return { proceed: false, step: "spend_check", reason, pre, cap };
|
|
476
|
+
}
|
|
477
|
+
}
|
|
478
|
+
if (shouldEscalate(cfg, scoped, false)) {
|
|
479
|
+
const relayed = await maybeRelay(cfg, scoped, "escalated to Approval Relay");
|
|
480
|
+
relayed.pre = pre;
|
|
481
|
+
relayed.cap = cap;
|
|
482
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, payTo, amountUsd, proceed: false, step: "approval_relay", reason: relayed.reason });
|
|
483
|
+
return relayed;
|
|
484
|
+
}
|
|
485
|
+
if (store && cfg.dailyMaxUsd != null && amountUsd != null) {
|
|
486
|
+
await store.add(budgetKey(cfg.payer), Number(amountUsd));
|
|
487
|
+
}
|
|
488
|
+
const ok = { proceed: true, step: "ok", amountUsd, host, payTo, pre, cap };
|
|
489
|
+
await appendLog(cfg, { event: "decision", payer: cfg.payer, sellerUrl: input.sellerUrl, host, payTo, amountUsd, proceed: true, step: "ok" });
|
|
490
|
+
return ok;
|
|
491
|
+
}
|
|
492
|
+
export async function assertAllowed(input, cfg) {
|
|
493
|
+
const result = await beforePay(input, cfg);
|
|
494
|
+
if (!result.proceed)
|
|
495
|
+
throw new PaymentBlockedError(result);
|
|
496
|
+
return result;
|
|
497
|
+
}
|
|
498
|
+
export function inputFromPaymentContext(ctx, cfg = {}) {
|
|
499
|
+
const pr = ctx.paymentRequired ?? ctx.payment_required;
|
|
500
|
+
const sel = ctx.selectedRequirements ?? ctx.selected_requirements ?? {};
|
|
501
|
+
return {
|
|
502
|
+
sellerUrl: sellerUrlFromContext(ctx),
|
|
503
|
+
paymentRequired: encodePaymentRequired(pr),
|
|
504
|
+
amountUsd: amountToUsd(sel, cfg.assetDecimals),
|
|
505
|
+
payTo: sel.payTo ?? sel.pay_to,
|
|
506
|
+
network: sel.network,
|
|
507
|
+
asset: sel.asset,
|
|
508
|
+
host: hostOf(sellerUrlFromContext(ctx)),
|
|
509
|
+
};
|
|
510
|
+
}
|
|
511
|
+
/** Official x402 client hook: return { abort: true, reason } to stop signing. */
|
|
512
|
+
export function createBeforePaymentCreationHook(cfg) {
|
|
513
|
+
return async (ctx) => {
|
|
514
|
+
const result = await beforePay(inputFromPaymentContext(ctx, cfg), cfg);
|
|
515
|
+
if (!result.proceed)
|
|
516
|
+
return { abort: true, reason: result.reason };
|
|
517
|
+
};
|
|
518
|
+
}
|
|
519
|
+
export function createAfterPaymentCreationHook(cfg) {
|
|
520
|
+
return async (ctx) => {
|
|
521
|
+
const input = inputFromPaymentContext(ctx, cfg);
|
|
522
|
+
await appendLog(cfg, {
|
|
523
|
+
event: "payload_created",
|
|
524
|
+
payer: cfg.payer,
|
|
525
|
+
sellerUrl: input.sellerUrl,
|
|
526
|
+
host: input.host,
|
|
527
|
+
payTo: input.payTo,
|
|
528
|
+
amountUsd: input.amountUsd != null ? String(input.amountUsd) : undefined,
|
|
529
|
+
proceed: true,
|
|
530
|
+
step: "payload_created",
|
|
531
|
+
});
|
|
532
|
+
};
|
|
533
|
+
}
|
|
534
|
+
export function createPaymentResponseHook(cfg) {
|
|
535
|
+
return async (ctx) => {
|
|
536
|
+
const reqs = ctx?.requirements ?? ctx?.selectedRequirements ?? ctx?.selected_requirements ?? {};
|
|
537
|
+
const pr = ctx?.paymentRequired ?? ctx?.payment_required;
|
|
538
|
+
const sellerUrl = sellerUrlFromContext({ paymentRequired: pr, selectedRequirements: reqs }) || ctx?.sellerUrl;
|
|
539
|
+
const amountUsd = amountToUsd(reqs, cfg.assetDecimals);
|
|
540
|
+
const settle = ctx?.settleResponse ?? ctx?.settle_response;
|
|
541
|
+
const ok = !ctx?.error && (settle == null || settle.success !== false);
|
|
542
|
+
await appendLog(cfg, {
|
|
543
|
+
event: ok ? "paid" : "record_failed",
|
|
544
|
+
payer: cfg.payer,
|
|
545
|
+
sellerUrl,
|
|
546
|
+
host: hostOf(sellerUrl || ""),
|
|
547
|
+
payTo: reqs.payTo ?? reqs.pay_to,
|
|
548
|
+
amountUsd,
|
|
549
|
+
proceed: ok,
|
|
550
|
+
step: ok ? "paid" : "record_failed",
|
|
551
|
+
reason: ctx?.error ? String(ctx.error?.message || ctx.error) : (settle && settle.success === false ? "settle failed" : undefined),
|
|
552
|
+
});
|
|
553
|
+
if (ok && cfg.recordSpend) {
|
|
554
|
+
await postSpendRecord(cfg, {
|
|
555
|
+
sellerUrl: sellerUrl || "",
|
|
556
|
+
amountUsd,
|
|
557
|
+
payTo: reqs.payTo ?? reqs.pay_to,
|
|
558
|
+
host: hostOf(sellerUrl || ""),
|
|
559
|
+
network: reqs.network,
|
|
560
|
+
paymentRequired: encodePaymentRequired(pr),
|
|
561
|
+
});
|
|
562
|
+
}
|
|
563
|
+
};
|
|
564
|
+
}
|
|
565
|
+
/** Duck-typed adapter for x402Client / @x402/fetch (v2.30+). Does not import @x402/core. */
|
|
566
|
+
export function attachToX402Client(client, cfg) {
|
|
567
|
+
const before = client.onBeforePaymentCreation ?? client.on_before_payment_creation;
|
|
568
|
+
if (typeof before !== "function") {
|
|
569
|
+
throw new Error("client.onBeforePaymentCreation is missing; need @x402/core x402Client >= 2.30 or a compatible client");
|
|
570
|
+
}
|
|
571
|
+
before.call(client, createBeforePaymentCreationHook(cfg));
|
|
572
|
+
const after = client.onAfterPaymentCreation ?? client.on_after_payment_creation;
|
|
573
|
+
if (typeof after === "function")
|
|
574
|
+
after.call(client, createAfterPaymentCreationHook(cfg));
|
|
575
|
+
const paid = client.onPaymentResponse ?? client.on_payment_response;
|
|
576
|
+
if (typeof paid === "function")
|
|
577
|
+
paid.call(client, createPaymentResponseHook(cfg));
|
|
578
|
+
return client;
|
|
579
|
+
}
|
|
580
|
+
export async function postSpendRecord(cfg, input) {
|
|
581
|
+
try {
|
|
582
|
+
return await mtCall(cfg, cfg.spendRecordUrl ?? DEFAULTS.spendRecordUrl, {
|
|
583
|
+
method: "POST",
|
|
584
|
+
headers: { "content-type": "application/json" },
|
|
585
|
+
body: JSON.stringify({
|
|
586
|
+
payer: cfg.payer,
|
|
587
|
+
paymentRequired: input.paymentRequired,
|
|
588
|
+
amountUsd: input.amountUsd,
|
|
589
|
+
payTo: input.payTo,
|
|
590
|
+
host: input.host,
|
|
591
|
+
network: input.network,
|
|
592
|
+
sessionId: cfg.sessionId,
|
|
593
|
+
}),
|
|
594
|
+
});
|
|
595
|
+
}
|
|
596
|
+
catch (err) {
|
|
597
|
+
await appendLog(cfg, {
|
|
598
|
+
event: "record_failed",
|
|
599
|
+
payer: cfg.payer,
|
|
600
|
+
sellerUrl: input.sellerUrl,
|
|
601
|
+
host: input.host,
|
|
602
|
+
payTo: input.payTo,
|
|
603
|
+
amountUsd: input.amountUsd != null ? String(input.amountUsd) : undefined,
|
|
604
|
+
proceed: false,
|
|
605
|
+
step: "record_failed",
|
|
606
|
+
reason: err instanceof Error ? err.message : String(err),
|
|
607
|
+
});
|
|
608
|
+
return undefined;
|
|
609
|
+
}
|
|
610
|
+
}
|
|
611
|
+
export function wrapFetch(baseFetch, cfg) {
|
|
612
|
+
const wrapped = (async (input, init) => {
|
|
613
|
+
const headers = mergeHeaders(input, init);
|
|
614
|
+
if (hasPaymentHeader(headers))
|
|
615
|
+
return baseFetch(input, init);
|
|
616
|
+
const res = await baseFetch(input, init);
|
|
617
|
+
if (res.status !== 402)
|
|
618
|
+
return res;
|
|
619
|
+
const paymentRequired = res.headers.get("PAYMENT-REQUIRED") || res.headers.get("payment-required") || await res.clone().text();
|
|
620
|
+
await assertAllowed({
|
|
621
|
+
sellerUrl: requestUrl(input),
|
|
622
|
+
method: init?.method || (typeof Request !== "undefined" && input instanceof Request ? input.method : "GET"),
|
|
623
|
+
paymentRequired,
|
|
624
|
+
host: hostOf(requestUrl(input)),
|
|
625
|
+
}, cfg);
|
|
626
|
+
return res;
|
|
627
|
+
});
|
|
628
|
+
return wrapped;
|
|
629
|
+
}
|
|
630
|
+
/**
|
|
631
|
+
* Axios response interceptor, unshifted so it runs before a payment adapter.
|
|
632
|
+
* Prefer composing like wrapFetch: payment wrapper outside, this inside.
|
|
633
|
+
*/
|
|
634
|
+
export function wrapAxios(instance, cfg) {
|
|
635
|
+
const onSuccess = async (res) => {
|
|
636
|
+
const status = res?.status;
|
|
637
|
+
const headers = res?.config?.headers || res?.headers;
|
|
638
|
+
if (status === 402 && !hasPaymentHeader(headers)) {
|
|
639
|
+
const hdr = headerGet(res?.headers, "payment-required");
|
|
640
|
+
const sellerUrl = res?.config?.url || res?.request?.responseURL;
|
|
641
|
+
await assertAllowed({
|
|
642
|
+
sellerUrl: String(sellerUrl),
|
|
643
|
+
method: res?.config?.method,
|
|
644
|
+
paymentRequired: hdr || (typeof res?.data === "string" ? res.data : JSON.stringify(res?.data ?? "")),
|
|
645
|
+
host: hostOf(String(sellerUrl || "")),
|
|
646
|
+
}, cfg);
|
|
647
|
+
}
|
|
648
|
+
return res;
|
|
649
|
+
};
|
|
650
|
+
const onError = async (err) => {
|
|
651
|
+
const res = err?.response;
|
|
652
|
+
if (res?.status === 402 && !hasPaymentHeader(res?.config?.headers || res?.headers)) {
|
|
653
|
+
const hdr = headerGet(res?.headers, "payment-required");
|
|
654
|
+
const sellerUrl = res?.config?.url || "";
|
|
655
|
+
await assertAllowed({
|
|
656
|
+
sellerUrl: String(sellerUrl),
|
|
657
|
+
method: res?.config?.method,
|
|
658
|
+
paymentRequired: hdr || (typeof res?.data === "string" ? res.data : JSON.stringify(res?.data ?? "")),
|
|
659
|
+
host: hostOf(String(sellerUrl || "")),
|
|
660
|
+
}, cfg);
|
|
661
|
+
}
|
|
662
|
+
throw err;
|
|
663
|
+
};
|
|
664
|
+
instance.interceptors.response.use(onSuccess, onError);
|
|
665
|
+
const handlers = instance.interceptors.response.handlers;
|
|
666
|
+
if (Array.isArray(handlers) && handlers.length > 1) {
|
|
667
|
+
const last = handlers.pop();
|
|
668
|
+
handlers.unshift(last);
|
|
669
|
+
}
|
|
670
|
+
return instance;
|
|
671
|
+
}
|
|
672
|
+
function headerGet(headers, name) {
|
|
673
|
+
if (!headers)
|
|
674
|
+
return undefined;
|
|
675
|
+
if (typeof headers.get === "function")
|
|
676
|
+
return headers.get(name) || headers.get(name.toUpperCase()) || undefined;
|
|
677
|
+
for (const [k, v] of Object.entries(headers))
|
|
678
|
+
if (k.toLowerCase() === name.toLowerCase())
|
|
679
|
+
return v == null ? undefined : String(v);
|
|
680
|
+
return undefined;
|
|
681
|
+
}
|
|
682
|
+
//# sourceMappingURL=moneytools-x402-guard.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"moneytools-x402-guard.js","sourceRoot":"","sources":["../ts/moneytools-x402-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW,EAAE,wCAAwC;IACrD,aAAa,EAAE,8CAA8C;IAC7D,cAAc,EAAE,+CAA+C;IAC/D,QAAQ,EAAE,2CAA2C;IACrD,SAAS,EAAE,yBAAyB,OAAO,EAAE;CACrC,CAAC;AAgGX,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,MAAM,CAAmB;IAClC,YAAY,MAAwB;QAClC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,MAAM,CAAS;IACf,IAAI,CAAU;IACvB,YAAY,MAAc,EAAE,OAAe,EAAE,IAAc;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,YAAY,GAAG,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,WAAW,CAAC,CAAC;AACpF,MAAM,mBAAmB,GAAG,iBAAiB,EAAE,CAAC;AAChD,MAAM,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;AAE5C,MAAM,UAAU,gBAAgB,CAAC,OAA6D;IAC5F,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE;QAC3B,IAAI,OAAQ,OAAmB,CAAC,GAAG,KAAK,UAAU;YAAE,OAAQ,OAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1F,MAAM,CAAC,GAAG,OAAkC,CAAC;QAC7C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE;gBAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACxH,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,IAAI,CAAC;QAAC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAQ,EAAE,QAA0B;IAChE,MAAM,MAAM,GAAG,GAAG,EAAE,iBAAiB,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,GAAG,EAAE,SAAS,IAAI,QAAQ,CAAC;IACvC,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE;IACnC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,GAAY;IACpD,OAAO,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,MAAM,EAAE,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,QAAiB;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,KAAK,4CAA4C;QAAE,OAAO,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3E,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5E,OAAO,CAAC,CAAC;AACX,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,WAAW,CAAC,GAAQ,EAAE,QAAiB;IACrD,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,iBAAiB,IAAI,GAAG,CAAC,mBAAmB,CAAC;IAC9G,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAClF,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAQ;IAC3C,MAAM,EAAE,GAAG,GAAG,EAAE,eAAe,IAAI,GAAG,EAAE,gBAAgB,IAAI,EAAE,CAAC;IAC/D,MAAM,GAAG,GAAG,GAAG,EAAE,oBAAoB,IAAI,GAAG,EAAE,qBAAqB,IAAI,EAAE,CAAC;IAC1E,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC;IAC7C,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1F,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAW;IAC/C,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,CAAC,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,OAAO;QACL,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,GAAG,CAAC,GAAG,EAAE,MAAM;YACb,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC;YACxC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAsB,EAAE,CAAC;IACnC,OAAO;QACL,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,CAAE,OAAe,CAAC,QAAQ,EAAE,IAAI,CAAC;AAC7E,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,IAAI,GAAG,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,GAAG,CAAC;IACtG,OAAO,GAAG,IAAI,gBAAgB,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,MAAM;IACnB,IAAI,CAAC,YAAY,EAAE;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAAa;IACrD,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC;IACzB,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,QAAQ,CAAC;IAAC,CAAC;AACxF,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,IAAS;IAClD,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE;QAAE,OAAO;IAChB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC;IAC1B,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM;YACnB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC;YAC7C,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACjB,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,UAAU,IAAI;QACjB,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;QAC1B,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;wBAAE,SAAS;oBAC3B,IAAI,CAAC;wBAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IACD,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,IAAI,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,EAAE;gBAAE,OAAO;YAChB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,KAAK,CAAC,IAAI;YACR,MAAM,IAAI,EAAE,CAAC;YACb,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAgB;IAC1C,IAAI,GAAG,CAAC,WAAW,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,GAAG,CAAC,WAAW;QAAE,OAAO,GAAG,CAAC,WAAW,CAAC;IAC5C,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,YAAY,EAAE;QAAE,OAAO,eAAe,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACtF,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAgB;IACzC,IAAI,GAAG,CAAC,WAAW,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,GAAG,CAAC,UAAU,CAAC;IAC1C,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAmB,EAAE;IACjD,OAAO,iBAAiB,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAgB,EAAE,KAAoD;IAC7F,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,UAAU,CAAC,KAAwB;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,YAAY,GAAG;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAC5C,OAAO,KAAK,CAAC,GAAG,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAwB,EAAE,IAAkB;IAChE,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;QAC/D,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,GAAgB,EAAE,GAAW,EAAE,OAAoB,EAAE;IACzE,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/F,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACtE,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClF,IAAI,GAAG,CAAC,OAAO;QAAE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1G,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,IAAI,GAAQ,IAAI,CAAC;IACrB,IAAI,CAAC;QAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;IACxE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC7C,MAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,CAAC,MAAM,oIAAoI,EAAE,IAAI,CAAC,CAAC;IACxO,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,GAAgB,EAAE,KAAqB,EAAE,SAAkB;IACjF,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC;IACnC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,IAAI,KAAK,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,GAAgB,EAAE,KAAqB,EAAE,MAAc;IAC/E,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACvE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC;IACrE,MAAM,IAAI,GAAG;QACX,cAAc,EAAE,OAAO,MAAM,YAAY,IAAI,OAAO,KAAK,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACnF,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,KAAK;QACrC,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,gBAAgB;YACtB,MAAM;YACN,QAAQ,EAAE;gBACR,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,QAAQ,EAAE,IAAI,EAAE,QAAQ;gBACxB,MAAM,EAAE,IAAI,EAAE,MAAM;aACrB;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,GAAG,MAAM,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG;SACjG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAqB,EAAE,MAAmB,EAAE;IAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,KAAK,KAAK,CAAC;IACvC,IAAI,GAAQ,CAAC;IAEb,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC3D,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAC3C,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACpE,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;gBACtC,MAAM,OAAO,GAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC5F,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvJ,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,IAAI,GAAG,CAAC,eAAe,KAAK,OAAO,EAAE,CAAC;gBACpC,gDAAgD;YAClD,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC1I,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;YACtD,CAAC;QACH,CAAC;QACD,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAC5B,IAAI,OAAO,KAAK,OAAO,IAAI,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACrE,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,oBAAoB,OAAO,EAAE,CAAC;gBAC5D,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC1I,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;YAC3D,CAAC;YACD,IAAI,OAAO,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;gBACzC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,kDAAkD,CAAC;gBACjF,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC1I,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC;IACnG,MAAM,MAAM,GAAmB,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAEpE,MAAM,WAAW,GAAG,KAAK,EAAE,MAAc,EAAE,GAAa,EAA6B,EAAE;QACrF,MAAM,OAAO,GAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACvF,IAAI,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACtD,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;YAClK,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1J,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,IAAI,GAAG,CAAC,MAAM,IAAI,IAAI,IAAI,SAAS,IAAI,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9E,OAAO,WAAW,CAAC,UAAU,SAAS,8BAA8B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,KAAK,IAAI,GAAG,CAAC,WAAW,IAAI,IAAI,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YAChD,OAAO,WAAW,CAAC,UAAU,SAAS,kCAAkC,GAAG,CAAC,WAAW,WAAW,KAAK,aAAa,CAAC,CAAC;QACxH,CAAC;IACH,CAAC;IAED,IAAI,GAAQ,CAAC;IACb,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,2CAA2C,CAAC;YAC3D,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3H,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC9D,CAAC;QACD,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,SAAS;gBACT,KAAK;gBACL,IAAI;gBACJ,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI;aAC9B,CAAC;SACH,CAAC,CAAC;QACH,IAAI,GAAG,EAAE,KAAK,KAAK,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;gBACzD,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,kBAAkB,CAAC;gBACvE,CAAC,CAAC,kBAAkB,CAAC;YACvB,IAAI,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;gBACtC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;gBACtD,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;gBAClB,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;gBAClB,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;gBAClK,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/J,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,6BAA6B,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;QAClB,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;QAClB,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAClL,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,IAAI,GAAG,CAAC,WAAW,IAAI,IAAI,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QAC1D,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,EAAE,GAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACxF,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7I,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAqB,EAAE,GAAgB;IACzE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC;AAChB,CAAC;AAWD,MAAM,UAAU,uBAAuB,CAAC,GAA+B,EAAE,MAAmB,EAAE;IAC5F,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,gBAAgB,CAAC;IACvD,MAAM,GAAG,GAAG,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;IACxE,OAAO;QACL,SAAS,EAAE,oBAAoB,CAAC,GAAG,CAAC;QACpC,eAAe,EAAE,qBAAqB,CAAC,EAAE,CAAC;QAC1C,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,aAAa,CAAC;QAC9C,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,+BAA+B,CAAC,GAAgB;IAC9D,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,uBAAuB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,GAAgB;IAC7D,OAAO,KAAK,EAAE,GAAyF,EAAE,EAAE;QACzG,MAAM,KAAK,GAAG,uBAAuB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChD,MAAM,SAAS,CAAC,GAAG,EAAE;YACnB,KAAK,EAAE,iBAAiB;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YACxE,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,iBAAiB;SACxB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAgB;IACxD,OAAO,KAAK,EAAE,GAAQ,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,GAAG,EAAE,YAAY,IAAI,GAAG,EAAE,oBAAoB,IAAI,GAAG,EAAE,qBAAqB,IAAI,EAAE,CAAC;QAChG,MAAM,EAAE,GAAG,GAAG,EAAE,eAAe,IAAI,GAAG,EAAE,gBAAgB,CAAC;QACzD,MAAM,SAAS,GAAG,oBAAoB,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,SAAS,CAAC;QAC9G,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,GAAG,EAAE,cAAc,IAAI,GAAG,EAAE,eAAe,CAAC;QAC3D,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;QACvE,MAAM,SAAS,CAAC,GAAG,EAAE;YACnB,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe;YACpC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS;YACT,IAAI,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM;YAChC,SAAS;YACT,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe;YACnC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;SAClI,CAAC,CAAC;QACH,IAAI,EAAE,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YAC1B,MAAM,eAAe,CAAC,GAAG,EAAE;gBACzB,SAAS,EAAE,SAAS,IAAI,EAAE;gBAC1B,SAAS;gBACT,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM;gBAChC,IAAI,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,eAAe,EAAE,qBAAqB,CAAC,EAAE,CAAC;aAC3C,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB,CAO/B,MAAS,EAAE,GAAgB;IAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,uBAAuB,IAAI,MAAM,CAAC,0BAA0B,CAAC;IACnF,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;IAC1H,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,+BAA+B,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,sBAAsB,IAAI,MAAM,CAAC,yBAAyB,CAAC;IAChF,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,8BAA8B,CAAC,GAAG,CAAC,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,mBAAmB,CAAC;IACpE,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAAG,CAAC,CAAC,CAAC;IAClF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAgB,EAAE,KAAqB;IAC3E,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc,EAAE;YACtE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,GAAG,CAAC,SAAS;aACzB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,CAAC,GAAG,EAAE;YACnB,KAAK,EAAE,eAAe;YACtB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YACxE,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAuB,EAAE,GAAgB;IACjE,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,KAAwB,EAAE,IAAkB,EAAE,EAAE;QACtE,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,gBAAgB,CAAC,OAAO,CAAC;YAAE,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,GAAG,CAAC;QACnC,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;QAC/H,MAAM,aAAa,CAAC;YAClB,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC;YAC5B,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YAC3G,eAAe;YACf,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;SAChC,EAAE,GAAG,CAAC,CAAC;QACR,OAAO,GAAG,CAAC;IACb,CAAC,CAAiB,CAAC;IACnB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAEtB,QAAW,EAAE,GAAgB;IAC9B,MAAM,SAAS,GAAG,KAAK,EAAE,GAAQ,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC;QAC3B,MAAM,OAAO,GAAG,GAAG,EAAE,MAAM,EAAE,OAAO,IAAI,GAAG,EAAE,OAAO,CAAC;QACrD,IAAI,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;YACxD,MAAM,SAAS,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC;YAChE,MAAM,aAAa,CAAC;gBAClB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;gBAC5B,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM;gBAC3B,eAAe,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;gBACpG,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;aACtC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,EAAE,GAAQ,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,GAAG,EAAE,QAAQ,CAAC;QAC1B,IAAI,GAAG,EAAE,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,IAAI,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;YACnF,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;YACxD,MAAM,SAAS,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;YACzC,MAAM,aAAa,CAAC;gBAClB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;gBAC5B,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM;gBAC3B,eAAe,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;gBACpG,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;aACtC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC;IACF,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC5B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,OAAY,EAAE,IAAY;IAC3C,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,SAAS,CAAC;IAChH,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnI,OAAO,SAAS,CAAC;AACnB,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,56 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@moneytools-dev/x402-guard",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.2.1",
|
|
4
|
+
"description": "Use this when an agent is about to pay an x402 seller: Pay Precheck, spend caps, daily budget, Approval Relay and a payment log, before anything is signed. Never loads a key or sends a payment.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/moneytools-x402-guard.js",
|
|
7
|
+
"types": "./dist/moneytools-x402-guard.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/moneytools-x402-guard.d.ts",
|
|
11
|
+
"import": "./dist/moneytools-x402-guard.js"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"files": [
|
|
15
|
+
"dist",
|
|
16
|
+
"LICENSE",
|
|
17
|
+
"README.md"
|
|
18
|
+
],
|
|
19
|
+
"license": "MIT",
|
|
20
|
+
"author": "MoneyTools",
|
|
21
|
+
"homepage": "https://moneytools.dev/products/payment-safety/",
|
|
22
|
+
"repository": {
|
|
23
|
+
"type": "git",
|
|
24
|
+
"url": "https://moneytools.dev/products/payment-safety/"
|
|
25
|
+
},
|
|
26
|
+
"bugs": {
|
|
27
|
+
"url": "https://moneytools.dev/products/payment-safety/"
|
|
28
|
+
},
|
|
29
|
+
"keywords": [
|
|
30
|
+
"x402",
|
|
31
|
+
"usdc",
|
|
32
|
+
"agent",
|
|
33
|
+
"payment",
|
|
34
|
+
"precheck",
|
|
35
|
+
"spend-cap"
|
|
36
|
+
],
|
|
37
|
+
"engines": {
|
|
38
|
+
"node": ">=18"
|
|
39
|
+
},
|
|
40
|
+
"scripts": {
|
|
41
|
+
"build": "tsc -p tsconfig.json",
|
|
42
|
+
"test": "node --experimental-strip-types --test ts/moneytools-x402-guard.test.ts"
|
|
43
|
+
},
|
|
44
|
+
"peerDependencies": {
|
|
45
|
+
"@x402/core": ">=2.30.0"
|
|
46
|
+
},
|
|
47
|
+
"peerDependenciesMeta": {
|
|
48
|
+
"@x402/core": {
|
|
49
|
+
"optional": true
|
|
50
|
+
}
|
|
51
|
+
},
|
|
52
|
+
"devDependencies": {
|
|
53
|
+
"typescript": "^5.9.3",
|
|
54
|
+
"@types/node": "^24.0.0"
|
|
55
|
+
}
|
|
56
|
+
}
|