@phala/pay 0.8.3 → 0.9.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.
Files changed (84) hide show
  1. package/README.md +20 -83
  2. package/dist/checkout.d.ts +4 -2
  3. package/dist/checkout.d.ts.map +1 -1
  4. package/dist/checkout.js +16 -1
  5. package/dist/checkout.js.map +1 -1
  6. package/dist/index.d.ts +5 -3
  7. package/dist/index.d.ts.map +1 -1
  8. package/dist/index.js +4 -3
  9. package/dist/index.js.map +1 -1
  10. package/dist/shared/checkout-params.d.ts +7 -0
  11. package/dist/shared/checkout-params.d.ts.map +1 -0
  12. package/dist/shared/checkout-params.js +2 -0
  13. package/dist/shared/checkout-params.js.map +1 -0
  14. package/package.json +16 -34
  15. package/src/checkout.ts +19 -2
  16. package/src/index.ts +5 -2
  17. package/src/shared/checkout-params.ts +6 -0
  18. package/dist/react/Checkout.d.ts +0 -43
  19. package/dist/react/Checkout.d.ts.map +0 -1
  20. package/dist/react/Checkout.js +0 -195
  21. package/dist/react/Checkout.js.map +0 -1
  22. package/dist/react/DepositAddress.d.ts +0 -32
  23. package/dist/react/DepositAddress.d.ts.map +0 -1
  24. package/dist/react/DepositAddress.js +0 -131
  25. package/dist/react/DepositAddress.js.map +0 -1
  26. package/dist/react/Field.d.ts +0 -7
  27. package/dist/react/Field.d.ts.map +0 -1
  28. package/dist/react/Field.js +0 -21
  29. package/dist/react/Field.js.map +0 -1
  30. package/dist/react/Icons.d.ts +0 -17
  31. package/dist/react/Icons.d.ts.map +0 -1
  32. package/dist/react/Icons.js +0 -18
  33. package/dist/react/Icons.js.map +0 -1
  34. package/dist/react/QrCode.d.ts +0 -8
  35. package/dist/react/QrCode.d.ts.map +0 -1
  36. package/dist/react/QrCode.js +0 -20
  37. package/dist/react/QrCode.js.map +0 -1
  38. package/dist/react/appearance.d.ts +0 -5
  39. package/dist/react/appearance.d.ts.map +0 -1
  40. package/dist/react/appearance.js +0 -2
  41. package/dist/react/appearance.js.map +0 -1
  42. package/dist/react/icon-paths.d.ts +0 -13
  43. package/dist/react/icon-paths.d.ts.map +0 -1
  44. package/dist/react/icon-paths.js +0 -14
  45. package/dist/react/icon-paths.js.map +0 -1
  46. package/dist/react/index.d.ts +0 -6
  47. package/dist/react/index.d.ts.map +0 -1
  48. package/dist/react/index.js +0 -6
  49. package/dist/react/index.js.map +0 -1
  50. package/dist/react/useCheckout.d.ts +0 -9
  51. package/dist/react/useCheckout.d.ts.map +0 -1
  52. package/dist/react/useCheckout.js +0 -32
  53. package/dist/react/useCheckout.js.map +0 -1
  54. package/dist/server/addresses.d.ts +0 -78
  55. package/dist/server/addresses.d.ts.map +0 -1
  56. package/dist/server/addresses.js +0 -118
  57. package/dist/server/addresses.js.map +0 -1
  58. package/dist/server/index.d.ts +0 -12
  59. package/dist/server/index.d.ts.map +0 -1
  60. package/dist/server/index.js +0 -12
  61. package/dist/server/index.js.map +0 -1
  62. package/dist/server/sweeps.d.ts +0 -78
  63. package/dist/server/sweeps.d.ts.map +0 -1
  64. package/dist/server/sweeps.js +0 -117
  65. package/dist/server/sweeps.js.map +0 -1
  66. package/dist/server/webhook.d.ts +0 -61
  67. package/dist/server/webhook.d.ts.map +0 -1
  68. package/dist/server/webhook.js +0 -154
  69. package/dist/server/webhook.js.map +0 -1
  70. package/src/css.d.ts +0 -1
  71. package/src/react/Checkout.tsx +0 -475
  72. package/src/react/DepositAddress.tsx +0 -240
  73. package/src/react/Field.tsx +0 -46
  74. package/src/react/Icons.tsx +0 -43
  75. package/src/react/QrCode.tsx +0 -39
  76. package/src/react/appearance.ts +0 -4
  77. package/src/react/icon-paths.tsx +0 -13
  78. package/src/react/index.ts +0 -7
  79. package/src/react/useCheckout.ts +0 -58
  80. package/src/server/addresses.ts +0 -223
  81. package/src/server/index.ts +0 -38
  82. package/src/server/sweeps.ts +0 -197
  83. package/src/server/webhook.ts +0 -208
  84. package/src/styles.css +0 -80
@@ -1,6 +0,0 @@
1
- export { Checkout, type CheckoutProps } from "./Checkout.js";
2
- export { DepositAddress, type DepositAddressProps } from "./DepositAddress.js";
3
- export { useCheckout, type UseCheckoutOptions, type UseCheckoutResult } from "./useCheckout.js";
4
- export type { Appearance } from "./appearance.js";
5
- export { NetworkIcon, AssetIcon, type IconProps, type NetworkIconProps, type AssetIconProps } from "./Icons.js";
6
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAChG,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}
@@ -1,6 +0,0 @@
1
- "use client";
2
- export { Checkout } from "./Checkout.js";
3
- export { DepositAddress } from "./DepositAddress.js";
4
- export { useCheckout } from "./useCheckout.js";
5
- export { NetworkIcon, AssetIcon } from "./Icons.js";
6
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAsB,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,cAAc,EAA4B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAmD,MAAM,kBAAkB,CAAC;AAEhG,OAAO,EAAE,WAAW,EAAE,SAAS,EAA8D,MAAM,YAAY,CAAC"}
@@ -1,9 +0,0 @@
1
- import { type CheckoutOptions, type CheckoutState } from "../checkout.js";
2
- export type UseCheckoutOptions = Pick<CheckoutOptions, "clientSecret" | "expectedAddress" | "apiBase" | "pollInterval" | "signal" | "requestTimeout">;
3
- export interface UseCheckoutResult extends CheckoutState {
4
- /** Reads the quote now, for example right after the wallet broadcast the payment. */
5
- refresh: () => void;
6
- }
7
- /** Follows a quote's public view for as long as the component is mounted. */
8
- export declare function useCheckout({ clientSecret, expectedAddress, apiBase, pollInterval, signal, requestTimeout, }: UseCheckoutOptions): UseCheckoutResult;
9
- //# sourceMappingURL=useCheckout.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"useCheckout.d.ts","sourceRoot":"","sources":["../../src/react/useCheckout.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,eAAe,EACf,cAAc,GAAG,iBAAiB,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,GAAG,gBAAgB,CAC9F,CAAC;AAEF,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,qFAAqF;IACrF,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAID,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,EAC1B,YAAY,EACZ,eAAe,EACf,OAAO,EACP,YAAY,EACZ,MAAM,EACN,cAAc,GACf,EAAE,kBAAkB,GAAG,iBAAiB,CA6BxC"}
@@ -1,32 +0,0 @@
1
- import { useCallback, useEffect, useRef, useState } from "react";
2
- import { createCheckout, } from "../checkout.js";
3
- const LOADING = { status: "loading", quote: null, error: null };
4
- /** Follows a quote's public view for as long as the component is mounted. */
5
- export function useCheckout({ clientSecret, expectedAddress, apiBase, pollInterval, signal, requestTimeout, }) {
6
- const [current, setCurrent] = useState({ key: "", state: LOADING });
7
- const checkout = useRef(null);
8
- const key = `${apiBase} ${clientSecret} ${expectedAddress}`;
9
- useEffect(() => {
10
- const instance = createCheckout({
11
- clientSecret,
12
- expectedAddress,
13
- apiBase,
14
- ...(pollInterval === undefined ? {} : { pollInterval }),
15
- ...(signal === undefined ? {} : { signal }),
16
- ...(requestTimeout === undefined ? {} : { requestTimeout }),
17
- });
18
- checkout.current = instance;
19
- const unsubscribe = instance.subscribe((state) => setCurrent({ key, state }));
20
- return () => {
21
- unsubscribe();
22
- instance.destroy();
23
- checkout.current = null;
24
- };
25
- }, [key, clientSecret, expectedAddress, apiBase, pollInterval, signal, requestTimeout]);
26
- const refresh = useCallback(() => {
27
- void checkout.current?.refresh();
28
- }, []);
29
- // A new client secret starts from `loading`, not from the previous quote's state.
30
- return { ...(current.key === key ? current.state : LOADING), refresh };
31
- }
32
- //# sourceMappingURL=useCheckout.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"useCheckout.js","sourceRoot":"","sources":["../../src/react/useCheckout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EACL,cAAc,GAIf,MAAM,gBAAgB,CAAC;AAYxB,MAAM,OAAO,GAAkB,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAE/E,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,EAC1B,YAAY,EACZ,eAAe,EACf,OAAO,EACP,YAAY,EACZ,MAAM,EACN,cAAc,GACK;IACnB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAyB,IAAI,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,YAAY,IAAI,eAAe,EAAE,CAAC;IAE5D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,cAAc,CAAC;YAC9B,YAAY;YACZ,eAAe;YACf,OAAO;YACP,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;YACvD,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;YAC3C,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;SAC5D,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC5B,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAC;YACd,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAExF,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,KAAK,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;IACnC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,kFAAkF;IAClF,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;AACzE,CAAC"}
@@ -1,78 +0,0 @@
1
- import { type Address, type Hex } from "viem";
2
- /**
3
- * The forwarder `factory` deploys for `treasury` and `salt`: OpenZeppelin 5.x
4
- * `Clones.predictDeterministicAddressWithImmutableArgs` with `abi.encodePacked(treasury)`, so the
5
- * address commits to the factory, the implementation, the treasury, and the salt.
6
- */
7
- export declare function forwarderAddress(factory: string, implementation: string, treasury: string, salt: Hex): Address;
8
- /** `keccak256(abi.encode(account, client_reference_id, "quote", quote_id))`: a quote's salt. */
9
- export declare function quoteSalt(account: string, clientReferenceId: string, quoteId: string): Hex;
10
- /**
11
- * `keccak256(abi.encode(account, livemode, client_reference_id, "deposit_address", version))`:
12
- * a deposit address's salt, the same on every chain.
13
- */
14
- export declare function depositAddressSalt(account: string, livemode: boolean, clientReferenceId: string, version: number | bigint): Hex;
15
- export interface Forwarder {
16
- factory: string;
17
- implementation: string;
18
- }
19
- /** The address of a quote over `treasury`, which you pin yourself (see `verifyQuoteAddress`). */
20
- export declare function quoteAddress(forwarder: Forwarder, quote: {
21
- client_reference_id: string;
22
- id: string;
23
- }, treasury: string, account: string): Address;
24
- /** A deposit address on the network whose treasury is `treasury`, which you pin yourself. */
25
- export declare function depositAddress(forwarder: Forwarder, address: {
26
- livemode: boolean;
27
- client_reference_id: string;
28
- version: number;
29
- }, treasury: string, account: string): Address;
30
- /** An address the service returned is not the one your pins derive: show nothing to pay. */
31
- export declare class AddressMismatchError extends Error {
32
- readonly name = "AddressMismatchError";
33
- }
34
- /**
35
- * What every address is recomputed from, configured on your server and never read from the
36
- * service: your account id (`acct_…`), the forwarder `factory` and `implementation` of the
37
- * attested deployment, and `treasuries`, your own treasury per chain id as you proved it. A
38
- * compromised service could return another treasury with the address that really derives from
39
- * it, so the response's `treasury` is never trusted.
40
- *
41
- * Live mode requires `treasuries`: without the chain's treasury the check fails closed. In test
42
- * mode an unpinned chain falls back to the response's treasury with a console warning.
43
- */
44
- export interface AddressPins extends Forwarder {
45
- account: string;
46
- treasuries?: Readonly<Record<number, string>> | undefined;
47
- }
48
- /**
49
- * Recomputes an open quote's address from your pins and returns it, the `expectedAddress` to
50
- * pass to `<Checkout>`. Throws `AddressMismatchError` unless the quote names your pinned
51
- * treasury of its chain and its address derives from it; in live mode also when the chain has no
52
- * pinned treasury.
53
- */
54
- export declare function verifyQuoteAddress(pins: AddressPins, quote: {
55
- id: string;
56
- livemode: boolean;
57
- chain_id: number;
58
- treasury: string;
59
- address: string;
60
- client_reference_id: string;
61
- }): Address;
62
- /**
63
- * Recomputes every network of an active deposit address from your pins and returns the address,
64
- * the same on every network. Throws `AddressMismatchError` as `verifyQuoteAddress` does, for any
65
- * network.
66
- */
67
- export declare function verifyDepositAddress(pins: AddressPins, address: {
68
- id: string;
69
- livemode: boolean;
70
- client_reference_id: string;
71
- version: number;
72
- networks: readonly {
73
- chain_id: number;
74
- treasury: string;
75
- address: string;
76
- }[];
77
- }): Address;
78
- //# sourceMappingURL=addresses.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../../src/server/addresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAEd;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,GACR,OAAO,CAgBT;AAED,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAO1F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,GAAG,CAaL;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAClD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAOT;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC5E,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAOT;AAED,4FAA4F;AAC5F,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAkB,IAAI,0BAA0B;CACjD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CAC3D;AAwCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE;IACL,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GACA,OAAO,CAST;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE;IACP,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9E,GACA,OAAO,CAgBT"}
@@ -1,118 +0,0 @@
1
- import { encodeAbiParameters, getAddress, getContractAddress, keccak256, concat, } from "viem";
2
- /**
3
- * The forwarder `factory` deploys for `treasury` and `salt`: OpenZeppelin 5.x
4
- * `Clones.predictDeterministicAddressWithImmutableArgs` with `abi.encodePacked(treasury)`, so the
5
- * address commits to the factory, the implementation, the treasury, and the salt.
6
- */
7
- export function forwarderAddress(factory, implementation, treasury, salt) {
8
- const initCode = concat([
9
- "0x61",
10
- "0x0041", // runtime length: the 45-byte proxy and the 20 treasury bytes
11
- "0x3d81600a3d39f3",
12
- "0x363d3d373d3d3d363d73",
13
- getAddress(implementation),
14
- "0x5af43d82803e903d91602b57fd5bf3",
15
- getAddress(treasury),
16
- ]);
17
- return getContractAddress({
18
- opcode: "CREATE2",
19
- from: getAddress(factory),
20
- salt,
21
- bytecodeHash: keccak256(initCode),
22
- });
23
- }
24
- /** `keccak256(abi.encode(account, client_reference_id, "quote", quote_id))`: a quote's salt. */
25
- export function quoteSalt(account, clientReferenceId, quoteId) {
26
- return keccak256(encodeAbiParameters([{ type: "string" }, { type: "string" }, { type: "string" }, { type: "string" }], [account, clientReferenceId, "quote", quoteId]));
27
- }
28
- /**
29
- * `keccak256(abi.encode(account, livemode, client_reference_id, "deposit_address", version))`:
30
- * a deposit address's salt, the same on every chain.
31
- */
32
- export function depositAddressSalt(account, livemode, clientReferenceId, version) {
33
- return keccak256(encodeAbiParameters([
34
- { type: "string" },
35
- { type: "bool" },
36
- { type: "string" },
37
- { type: "string" },
38
- { type: "uint256" },
39
- ], [account, livemode, clientReferenceId, "deposit_address", BigInt(version)]));
40
- }
41
- /** The address of a quote over `treasury`, which you pin yourself (see `verifyQuoteAddress`). */
42
- export function quoteAddress(forwarder, quote, treasury, account) {
43
- return forwarderAddress(forwarder.factory, forwarder.implementation, treasury, quoteSalt(account, quote.client_reference_id, quote.id));
44
- }
45
- /** A deposit address on the network whose treasury is `treasury`, which you pin yourself. */
46
- export function depositAddress(forwarder, address, treasury, account) {
47
- return forwarderAddress(forwarder.factory, forwarder.implementation, treasury, depositAddressSalt(account, address.livemode, address.client_reference_id, address.version));
48
- }
49
- /** An address the service returned is not the one your pins derive: show nothing to pay. */
50
- export class AddressMismatchError extends Error {
51
- name = "AddressMismatchError";
52
- }
53
- /**
54
- * The treasury an address on `chainId` must pay: the pinned one, which the response must name.
55
- */
56
- function pinnedTreasury(pins, livemode, chainId, treasury, where) {
57
- const pinned = pins.treasuries?.[chainId];
58
- if (pinned === undefined) {
59
- if (livemode) {
60
- throw new AddressMismatchError(`${where}: live mode requires your pinned treasury of chain ${chainId}`);
61
- }
62
- console.warn(`${where}: no pinned treasury of chain ${chainId}; the service's ${treasury} is trusted (test mode only)`);
63
- return treasury;
64
- }
65
- if (!sameAddress(pinned, treasury)) {
66
- throw new AddressMismatchError(`${where} pays a treasury that is not the pinned one`);
67
- }
68
- return pinned;
69
- }
70
- function requirePins(pins, where) {
71
- for (const field of ["account", "factory", "implementation"]) {
72
- if (typeof pins[field] !== "string" || pins[field] === "") {
73
- throw new AddressMismatchError(`${where}: the pinned ${field} is missing`);
74
- }
75
- }
76
- }
77
- function sameAddress(a, b) {
78
- return a.toLowerCase() === b.toLowerCase();
79
- }
80
- /**
81
- * Recomputes an open quote's address from your pins and returns it, the `expectedAddress` to
82
- * pass to `<Checkout>`. Throws `AddressMismatchError` unless the quote names your pinned
83
- * treasury of its chain and its address derives from it; in live mode also when the chain has no
84
- * pinned treasury.
85
- */
86
- export function verifyQuoteAddress(pins, quote) {
87
- const where = `quote ${quote.id}`;
88
- requirePins(pins, where);
89
- const treasury = pinnedTreasury(pins, quote.livemode, quote.chain_id, quote.treasury, where);
90
- const derived = quoteAddress(pins, quote, treasury, pins.account);
91
- if (!sameAddress(derived, quote.address)) {
92
- throw new AddressMismatchError(`${where} has an address the account cannot derive`);
93
- }
94
- return derived;
95
- }
96
- /**
97
- * Recomputes every network of an active deposit address from your pins and returns the address,
98
- * the same on every network. Throws `AddressMismatchError` as `verifyQuoteAddress` does, for any
99
- * network.
100
- */
101
- export function verifyDepositAddress(pins, address) {
102
- requirePins(pins, `deposit address ${address.id}`);
103
- let first;
104
- for (const network of address.networks) {
105
- const where = `deposit address ${address.id} on chain ${network.chain_id}`;
106
- const treasury = pinnedTreasury(pins, address.livemode, network.chain_id, network.treasury, where);
107
- const derived = depositAddress(pins, address, treasury, pins.account);
108
- if (!sameAddress(derived, network.address)) {
109
- throw new AddressMismatchError(`${where} is not one the account can derive`);
110
- }
111
- first ??= derived;
112
- }
113
- if (first === undefined) {
114
- throw new AddressMismatchError(`deposit address ${address.id} has no network`);
115
- }
116
- return first;
117
- }
118
- //# sourceMappingURL=addresses.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../src/server/addresses.ts"],"names":[],"mappings":"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"}
@@ -1,12 +0,0 @@
1
- /**
2
- * Server-side helpers of `@phala/pay`. Nothing here needs or takes an API key: webhook
3
- * verification uses your account's public webhook key, and the address and sweep helpers run
4
- * offline. Call the API itself from your backend with a restricted key (the Python SDK, or any
5
- * HTTP client with `Authorization: Bearer ppay_rk_…`); never ship a key to a browser. Recompute
6
- * every address with `verifyQuoteAddress` or `verifyDepositAddress` from the pins you configure
7
- * yourself before you show it.
8
- */
9
- export { WebhookSignatureError, constructEvent, type ConstructEventOptions, type WebhookEvent, } from "./webhook.js";
10
- export { AddressMismatchError, depositAddress, depositAddressSalt, forwarderAddress, quoteSalt, quoteAddress, verifyDepositAddress, verifyQuoteAddress, type AddressPins, type Forwarder, } from "./addresses.js";
11
- export { batchChecksum, flushTransaction, flushTransactions, safeBatch, type BatchFile, type BatchFileMeta, type BatchTransaction, type Call, type ForwarderObject, type SafeBatchOptions, } from "./sweeps.js";
12
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC"}
@@ -1,12 +0,0 @@
1
- /**
2
- * Server-side helpers of `@phala/pay`. Nothing here needs or takes an API key: webhook
3
- * verification uses your account's public webhook key, and the address and sweep helpers run
4
- * offline. Call the API itself from your backend with a restricted key (the Python SDK, or any
5
- * HTTP client with `Authorization: Bearer ppay_rk_…`); never ship a key to a browser. Recompute
6
- * every address with `verifyQuoteAddress` or `verifyDepositAddress` from the pins you configure
7
- * yourself before you show it.
8
- */
9
- export { WebhookSignatureError, constructEvent, } from "./webhook.js";
10
- export { AddressMismatchError, depositAddress, depositAddressSalt, forwarderAddress, quoteSalt, quoteAddress, verifyDepositAddress, verifyQuoteAddress, } from "./addresses.js";
11
- export { batchChecksum, flushTransaction, flushTransactions, safeBatch, } from "./sweeps.js";
12
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,qBAAqB,EACrB,cAAc,GAGf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,GAGnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GAOV,MAAM,aAAa,CAAC"}
@@ -1,78 +0,0 @@
1
- import { type Address, type Hex } from "viem";
2
- /** A contract call as a wallet or the Safe Transaction Builder takes it. */
3
- export interface Call {
4
- to: Address;
5
- data: Hex;
6
- /** Native value in wei, a decimal string: `"0"` for a flush. */
7
- value: string;
8
- }
9
- /**
10
- * `factory.flush(treasury, salts, token)`, encoded offline from the exported forwarders
11
- * (`GET /v1/forwarders`): every listed forwarder's whole balance of `token` moves to `treasury`,
12
- * the only address it can pay. Anyone may send it; the sender pays the gas.
13
- */
14
- export declare function flushTransaction(factory: string, treasury: string, salts: readonly Hex[], token: string): Call;
15
- /** A forwarder as `GET /v1/forwarders` returns it. */
16
- export interface ForwarderObject {
17
- chain_id: number;
18
- factory: string;
19
- treasury: string;
20
- salt: string;
21
- }
22
- /**
23
- * Groups forwarders of one chain, such as `GET /v1/forwarders?sweepable=<token>` lists, into
24
- * `flushTransaction` calls: one per factory and treasury, of at most `maxSalts` forwarders.
25
- */
26
- export declare function flushTransactions(forwarders: Iterable<ForwarderObject>, token: string, maxSalts?: number): Call[];
27
- /**
28
- * The Safe Transaction Builder's batch file, its `BatchFile` type
29
- * (safe-global/safe-react-apps, `apps/tx-builder/src/typings/models.ts` at commit
30
- * e8cccfb9a1042fa2954087988bae59c3b8c81780).
31
- */
32
- export interface BatchFile {
33
- version: string;
34
- chainId: string;
35
- createdAt: number;
36
- meta: BatchFileMeta;
37
- transactions: BatchTransaction[];
38
- }
39
- export interface BatchFileMeta {
40
- txBuilderVersion?: string;
41
- checksum?: string;
42
- createdFromSafeAddress?: string;
43
- createdFromOwnerAddress?: string;
44
- name: string;
45
- description?: string;
46
- }
47
- export interface BatchTransaction {
48
- to: string;
49
- value: string;
50
- data?: string;
51
- contractMethod?: {
52
- inputs: unknown[];
53
- name: string;
54
- payable: boolean;
55
- };
56
- contractInputsValues?: {
57
- [key: string]: string;
58
- };
59
- }
60
- export interface SafeBatchOptions {
61
- name?: string;
62
- description?: string;
63
- /** Milliseconds; now by default. */
64
- createdAt?: number;
65
- }
66
- /**
67
- * A Transaction Builder batch file of `calls` for the Safe `safe` on `chainId`, with the app's
68
- * `meta.checksum`, so it imports without the "modified since it was generated" warning. A Safe
69
- * owner imports it in Safe{Wallet} > Apps > Transaction Builder; the owners sign and execute it.
70
- */
71
- export declare function safeBatch(chainId: number, safe: string, calls: readonly Call[], options?: SafeBatchOptions): BatchFile;
72
- /**
73
- * The Transaction Builder's `meta.checksum` (`apps/tx-builder/src/lib/checksum.ts`): Keccak-256
74
- * of its key-sorted serialization with `meta.name` set to `null`, over the file without its
75
- * checksum, as the app's `validateChecksum` recomputes it.
76
- */
77
- export declare function batchChecksum(batch: BatchFile): Hex;
78
- //# sourceMappingURL=sweeps.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sweeps.d.ts","sourceRoot":"","sources":["../../src/server/sweeps.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAgBd,4EAA4E;AAC5E,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,GAAG,EAAE,EACrB,KAAK,EAAE,MAAM,GACZ,IAAI,CAgBN;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,QAAQ,CAAC,eAAe,CAAC,EACrC,KAAK,EAAE,MAAM,EACb,QAAQ,SAAM,GACb,IAAI,EAAE,CAyBR;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE;QAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACvE,oBAAoB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAsBX;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAInD"}
@@ -1,117 +0,0 @@
1
- import { encodeFunctionData, getAddress, isHex, keccak256, stringToBytes, } from "viem";
2
- const FLUSH_ABI = [
3
- {
4
- type: "function",
5
- name: "flush",
6
- stateMutability: "nonpayable",
7
- inputs: [
8
- { name: "treasury", type: "address" },
9
- { name: "salts", type: "bytes32[]" },
10
- { name: "token", type: "address" },
11
- ],
12
- outputs: [],
13
- },
14
- ];
15
- /**
16
- * `factory.flush(treasury, salts, token)`, encoded offline from the exported forwarders
17
- * (`GET /v1/forwarders`): every listed forwarder's whole balance of `token` moves to `treasury`,
18
- * the only address it can pay. Anyone may send it; the sender pays the gas.
19
- */
20
- export function flushTransaction(factory, treasury, salts, token) {
21
- if (salts.length === 0) {
22
- throw new TypeError("flush needs at least one salt");
23
- }
24
- if (!salts.every((salt) => isHex(salt) && salt.length === 66)) {
25
- throw new TypeError("a salt is 32 bytes of hex");
26
- }
27
- return {
28
- to: getAddress(factory),
29
- data: encodeFunctionData({
30
- abi: FLUSH_ABI,
31
- functionName: "flush",
32
- args: [getAddress(treasury), salts, getAddress(token)],
33
- }),
34
- value: "0",
35
- };
36
- }
37
- /**
38
- * Groups forwarders of one chain, such as `GET /v1/forwarders?sweepable=<token>` lists, into
39
- * `flushTransaction` calls: one per factory and treasury, of at most `maxSalts` forwarders.
40
- */
41
- export function flushTransactions(forwarders, token, maxSalts = 200) {
42
- const groups = new Map();
43
- const chains = new Set();
44
- for (const forwarder of forwarders) {
45
- chains.add(forwarder.chain_id);
46
- const factory = getAddress(forwarder.factory);
47
- const treasury = getAddress(forwarder.treasury);
48
- const key = `${factory}:${treasury}`;
49
- const group = groups.get(key) ?? { factory, treasury, salts: [] };
50
- if (!isHex(forwarder.salt)) {
51
- throw new TypeError("a salt is 32 bytes of hex");
52
- }
53
- group.salts.push(forwarder.salt);
54
- groups.set(key, group);
55
- }
56
- if (chains.size > 1) {
57
- throw new TypeError("a batch of flush calls is for one chain");
58
- }
59
- const calls = [];
60
- for (const { factory, treasury, salts } of groups.values()) {
61
- for (let start = 0; start < salts.length; start += maxSalts) {
62
- calls.push(flushTransaction(factory, treasury, salts.slice(start, start + maxSalts), token));
63
- }
64
- }
65
- return calls;
66
- }
67
- /**
68
- * A Transaction Builder batch file of `calls` for the Safe `safe` on `chainId`, with the app's
69
- * `meta.checksum`, so it imports without the "modified since it was generated" warning. A Safe
70
- * owner imports it in Safe{Wallet} > Apps > Transaction Builder; the owners sign and execute it.
71
- */
72
- export function safeBatch(chainId, safe, calls, options = {}) {
73
- if (calls.length === 0) {
74
- throw new TypeError("a batch needs at least one call");
75
- }
76
- const batch = {
77
- version: "1.0",
78
- chainId: String(chainId),
79
- createdAt: options.createdAt ?? Date.now(),
80
- meta: {
81
- name: options.name ?? "Phala Pay sweep",
82
- description: options.description ?? "",
83
- createdFromSafeAddress: getAddress(safe),
84
- },
85
- transactions: calls.map((call) => {
86
- if (!/^\d+$/.test(call.value) || !isHex(call.data)) {
87
- throw new TypeError("a call needs hex data and a decimal value");
88
- }
89
- return { to: getAddress(call.to), value: call.value, data: call.data };
90
- }),
91
- };
92
- batch.meta.checksum = batchChecksum(batch);
93
- return batch;
94
- }
95
- /**
96
- * The Transaction Builder's `meta.checksum` (`apps/tx-builder/src/lib/checksum.ts`): Keccak-256
97
- * of its key-sorted serialization with `meta.name` set to `null`, over the file without its
98
- * checksum, as the app's `validateChecksum` recomputes it.
99
- */
100
- export function batchChecksum(batch) {
101
- const meta = { ...batch.meta, name: null };
102
- delete meta["checksum"];
103
- return keccak256(stringToBytes(serialize({ ...batch, meta })));
104
- }
105
- /** The app's `serializeJSONObject`. */
106
- function serialize(value) {
107
- if (Array.isArray(value)) {
108
- return `[${value.map(serialize).join(",")}]`;
109
- }
110
- if (typeof value === "object" && value !== null) {
111
- const record = value;
112
- const keys = Object.keys(record).sort();
113
- return `{${JSON.stringify(keys)}${keys.map((key) => `${serialize(record[key])},`).join("")}}`;
114
- }
115
- return JSON.stringify(value === undefined ? null : value);
116
- }
117
- //# sourceMappingURL=sweeps.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sweeps.js","sourceRoot":"","sources":["../../src/server/sweeps.ts"],"names":[],"mappings":"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"}
@@ -1,61 +0,0 @@
1
- /**
2
- * Standard Webhooks `v1a` verification of Phala Pay deliveries (design D11): an ed25519 signature
3
- * over `{webhook-id}.{webhook-timestamp}.{body}` by your account's webhook key in the endpoint's
4
- * mode, pinned from `GET /v1/attestation`. Uses WebCrypto, so it runs on Node 20+, Deno, Bun, and
5
- * edge runtimes.
6
- */
7
- /** A delivery that did not verify: answer `400` and do nothing. */
8
- export declare class WebhookSignatureError extends Error {
9
- readonly name = "WebhookSignatureError";
10
- }
11
- /** A verified event. `data.object` is the object the event is about, such as a deposit. */
12
- export interface WebhookEvent {
13
- /** `evt_…`, stable across retries and resends: process each id once. */
14
- id: string;
15
- object: "event";
16
- /** Your account, `acct_…`. */
17
- account: string;
18
- livemode: boolean;
19
- /** Such as `deposit.credited`; claw back a `deposit.reversed` deposit's credit. */
20
- type: string;
21
- created: number;
22
- /** Who caused it: an API key id (`key_…`), `admin`, or `system`. */
23
- actor: string;
24
- /**
25
- * The API request that caused it, with the `Idempotency-Key` it sent; `null` when the
26
- * service's own workers did (a payment credited, a quote expired).
27
- */
28
- request: {
29
- id: string;
30
- idempotency_key: string | null;
31
- } | null;
32
- /**
33
- * `object` is the object as it was when the event happened, never re-rendered; `*.updated`
34
- * events add `previous_attributes`, the former values of what changed.
35
- */
36
- data: {
37
- object: Record<string, unknown>;
38
- previous_attributes?: Record<string, unknown>;
39
- };
40
- }
41
- export interface ConstructEventOptions {
42
- /** Your account id, `acct_…`: an event of another account fails closed. */
43
- expectedAccount: string;
44
- /** The mode of the endpoint receiving it: an event of the other mode fails closed. */
45
- expectedLivemode: boolean;
46
- /** Finite, non-negative seconds a delivery's timestamp may differ from now; default 300. */
47
- tolerance?: number;
48
- /** Finite current time in Unix seconds; for tests. */
49
- now?: number;
50
- }
51
- /**
52
- * Verifies a delivery and returns its event, as Stripe's `constructEvent` does, failing closed
53
- * unless a `v1a` signature verifies with one of `publicKeys` (ed25519 keys in Standard Webhooks'
54
- * `whpk_` form, as `GET /v1/attestation` lists them; pass both while a rotation overlaps), the
55
- * timestamp is within tolerance, the body's id is the `webhook-id`, and the event is
56
- * `expectedAccount`'s in `expectedLivemode`.
57
- *
58
- * `payload` is the raw request body, before any JSON parsing.
59
- */
60
- export declare function constructEvent(payload: string | Uint8Array, headers: Headers | Record<string, string | string[] | undefined>, publicKeys: string | readonly string[], options: ConstructEventOptions): Promise<WebhookEvent>;
61
- //# sourceMappingURL=webhook.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/server/webhook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mEAAmE;AACnE,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAkB,IAAI,2BAA2B;CAClD;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/D;;;OAGG;IACH,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAC1F;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EAChE,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACtC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAgGvB"}