phygital-payment-sdk 0.1.0

package/dist/core/errors.js

@@ -0,0 +1,204 @@
+import { isSolanaError, SOLANA_ERROR__INSTRUCTION_ERROR__CUSTOM } from "@solana/kit";
+import { getPhygitalPaymentErrorMessage } from "../generated/errors/phygitalPayment.js";
+export class PhygitalPaymentSdkError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+const PROGRAM_ERROR_NAMES = [
+    "AuthorizationExpired",
+    "AuthorizationTtlExceeded",
+    "InvalidAmount",
+    "InvalidPaymentStatus",
+    "CaptureWindowNotElapsed",
+    "CaptureWindowElapsed",
+    "UnauthorizedPayer",
+    "UnauthorizedMerchant",
+    "UnauthorizedArbiter",
+    "ResolveDeadlineNotMet",
+    "MerchantResponded",
+    "InsufficientDisputeBond",
+    "InvalidConfigValue",
+    "ArbiterNotConfigured",
+    "ArbiterRequired",
+    "UnauthorizedRentPayer",
+    "TooManyDisputeStrikes",
+    "ArbiterDeadlineNotMet",
+    "InsufficientAmount",
+    "InvalidReference",
+    "MissingInstructionsSysvar",
+    "InvalidSecp256r1Instruction",
+    "SignatureIndexOutOfBounds",
+    "InvalidSignatureOffsets",
+    "InvalidSecp256r1PublicKey",
+    "InvalidPublicKey",
+    "ReserveViolated",
+    "InvalidCredential",
+    "UnsupportedMintExtension",
+    "PartialRefundWhileDisputed",
+    "InvalidPreDisputeMarker",
+    "TapLimitNotSet",
+    "TapLimitExceeded",
+    "ArbiterNotRegistered",
+    "AuthorizationAlreadyUsed",
+    "AuthorizationNotExpired",
+];
+const PROGRAM_ERROR_BASE = 6000;
+export function programErrorName(errorCode) {
+    return (PROGRAM_ERROR_NAMES[errorCode - PROGRAM_ERROR_BASE] ??
+        `UnknownProgramError(${errorCode})`);
+}
+export class ProgramExecutionError extends PhygitalPaymentSdkError {
+    code = "program_error";
+    errorCode;
+    errorName;
+    signature;
+    logs;
+    constructor(errorCode, ctx = {}) {
+        const name = programErrorName(errorCode);
+        let detail = "";
+        try {
+            detail = getPhygitalPaymentErrorMessage(errorCode);
+        }
+        catch {
+        }
+        super(`Program error ${errorCode} (${name})${detail ? `: ${detail}` : ""}`, { cause: ctx.cause });
+        this.errorCode = errorCode;
+        this.errorName = name;
+        this.signature = ctx.signature;
+        this.logs = ctx.logs;
+    }
+}
+export class SimulationError extends PhygitalPaymentSdkError {
+    code = "simulation_failed";
+    transactionError;
+    logs;
+    constructor(transactionError, ctx = {}) {
+        super(`Transaction simulation failed: ${stringifyTransactionError(transactionError)}`, {
+            cause: ctx.cause,
+        });
+        this.transactionError = transactionError;
+        this.logs = ctx.logs;
+    }
+}
+export class ProviderHttpError extends PhygitalPaymentSdkError {
+    code = "provider_http_error";
+    endpoint;
+    status;
+    body;
+    constructor(endpoint, status, body, options) {
+        super(`Provider endpoint ${endpoint} failed with status ${status}${body ? `: ${body}` : ""}`, options);
+        this.endpoint = endpoint;
+        this.status = status;
+        this.body = body;
+    }
+}
+export class TapReadError extends PhygitalPaymentSdkError {
+    code = "tap_read_failed";
+    aborted;
+    constructor(message, ctx = {}) {
+        super(message, { cause: ctx.cause });
+        this.aborted = ctx.aborted ?? false;
+    }
+}
+export class EnablerMismatchError extends PhygitalPaymentSdkError {
+    code = "enabler_mismatch";
+    expected;
+    actual;
+    constructor(expected, actual) {
+        super("Enabler public key returned by the payment provider does not match the key registered on the payer's payment account.");
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+export class PolicyViolationError extends PhygitalPaymentSdkError {
+    code = "policy_violation";
+    rule;
+    detail;
+    constructor(rule, detail) {
+        super(`Policy violation (${rule})${detail ? `: ${detail}` : ""}`);
+        this.rule = rule;
+        this.detail = detail;
+    }
+}
+export class EnvironmentError extends PhygitalPaymentSdkError {
+    code = "wrong_environment";
+}
+export class InvalidReferenceError extends PhygitalPaymentSdkError {
+    code = "invalid_reference";
+}
+export class ConfigurationError extends PhygitalPaymentSdkError {
+    code = "configuration_error";
+}
+export class InvalidAmountError extends PhygitalPaymentSdkError {
+    code = "invalid_amount";
+}
+export class TapLimitError extends PhygitalPaymentSdkError {
+    code = "tap_limit_exceeded";
+    amount;
+    limit;
+    constructor(amount, limit) {
+        super(limit === 0n
+            ? "The payer has not set a per-tap limit; no tap can be authorized until they do."
+            : `Tap amount ${amount} exceeds the payer's on-chain per-tap limit ${limit}.`);
+        this.amount = amount;
+        this.limit = limit;
+    }
+}
+export class ArbiterNotApprovedError extends PhygitalPaymentSdkError {
+    code = "arbiter_not_approved";
+}
+export class ArbiterRejectedError extends PhygitalPaymentSdkError {
+    code = "arbiter_rejected";
+    arbiter;
+    constructor(arbiter, detail) {
+        super(`Merchant policy rejected the payer's approved arbiter ${arbiter}${detail ? `: ${detail}` : ""}.`);
+        this.arbiter = arbiter;
+    }
+}
+function stringifyTransactionError(err) {
+    if (typeof err === "string")
+        return err;
+    try {
+        return JSON.stringify(err, (_k, v) => typeof v === "bigint" ? v.toString() : v);
+    }
+    catch {
+        return String(err);
+    }
+}
+export function extractCustomErrorCode(transactionError) {
+    if (typeof transactionError !== "object" || transactionError === null)
+        return null;
+    const instructionError = transactionError["InstructionError"];
+    if (!Array.isArray(instructionError) || instructionError.length < 2)
+        return null;
+    const detail = instructionError[1];
+    if (typeof detail === "object" && detail !== null && "Custom" in detail) {
+        const code = detail["Custom"];
+        if (typeof code === "number")
+            return code;
+    }
+    return null;
+}
+export function toSdkError(error, ctx = {}) {
+    if (error instanceof PhygitalPaymentSdkError)
+        return error;
+    for (const candidate of [error, error?.cause]) {
+        if (isSolanaError(candidate, SOLANA_ERROR__INSTRUCTION_ERROR__CUSTOM)) {
+            const code = Number(candidate.context.code);
+            if (code >= PROGRAM_ERROR_BASE &&
+                code < PROGRAM_ERROR_BASE + PROGRAM_ERROR_NAMES.length) {
+                return new ProgramExecutionError(code, { ...ctx, cause: error });
+            }
+        }
+    }
+    const customCode = extractCustomErrorCode(error);
+    if (customCode !== null &&
+        customCode >= PROGRAM_ERROR_BASE &&
+        customCode < PROGRAM_ERROR_BASE + PROGRAM_ERROR_NAMES.length) {
+        return new ProgramExecutionError(customCode, ctx);
+    }
+    return new SimulationError(error, { logs: ctx.logs, cause: error });
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}

package/dist/core/events.d.ts

@@ -0,0 +1,113 @@
+import { type Address, type Signature } from "@solana/kit";
+import type { RpcSubscriptions, SolanaRpcSubscriptionsApi } from "@solana/kit";
+import type { SdkRpc } from "./payment.js";
+export interface PaymentCreatedEvent {
+    payment: Address;
+    payer: Address;
+    merchant: Address;
+    mint: Address;
+    amount: bigint;
+    issuedAt: number;
+    captureAfter: number;
+    arbiter: Address;
+    reference: Uint8Array;
+}
+export interface PaymentCapturedEvent {
+    payment: Address;
+    payer: Address;
+    merchant: Address;
+    amount: bigint;
+}
+export interface PaymentRefundedEvent {
+    payment: Address;
+    payer: Address;
+    merchant: Address;
+    refunded: bigint;
+    remaining: bigint;
+}
+export interface PaymentDisputedEvent {
+    payment: Address;
+    payer: Address;
+    merchant: Address;
+    bondAmount: bigint;
+    payerEvidenceHash: Uint8Array;
+}
+export interface DisputeResolvedEvent {
+    payment: Address;
+    payer: Address;
+    merchant: Address;
+    arbiter: Address;
+    merchantAmount: bigint;
+    payerAmount: bigint;
+}
+export interface ReserveChangedEvent {
+    paymentAccount: Address;
+    owner: Address;
+    mint: Address;
+    reserveAmount: bigint;
+    pendingReserveAmount: bigint;
+    reserveEffectiveAt: number;
+}
+export interface SettledPaymentRefundedEvent {
+    payment: Address;
+    reference: Uint8Array;
+    payer: Address;
+    merchant: Address;
+    mint: Address;
+    amount: bigint;
+}
+export interface PaymentClosedEvent {
+    payment: Address;
+    payer: Address;
+    merchant: Address;
+    reference: Uint8Array;
+    status: number;
+}
+export type PhygitalPaymentEvent = {
+    type: "paymentCreated";
+    data: PaymentCreatedEvent;
+} | {
+    type: "paymentCaptured";
+    data: PaymentCapturedEvent;
+} | {
+    type: "paymentRefunded";
+    data: PaymentRefundedEvent;
+} | {
+    type: "paymentDisputed";
+    data: PaymentDisputedEvent;
+} | {
+    type: "disputeResolved";
+    data: DisputeResolvedEvent;
+} | {
+    type: "reserveChanged";
+    data: ReserveChangedEvent;
+} | {
+    type: "settledPaymentRefunded";
+    data: SettledPaymentRefundedEvent;
+} | {
+    type: "paymentClosed";
+    data: PaymentClosedEvent;
+};
+export type PhygitalPaymentEventType = PhygitalPaymentEvent["type"];
+export interface EventWithContext {
+    event: PhygitalPaymentEvent;
+    signature: Signature;
+    slot: bigint;
+    blockTime: number | null;
+}
+export declare function eventDiscriminator(rustName: string): Uint8Array;
+export declare function decodeEventData(bytes: Uint8Array): PhygitalPaymentEvent | null;
+export declare function decodeEventsFromLogs(logs: readonly string[], programAddress?: Address): PhygitalPaymentEvent[];
+export declare function getEventsForSignature(rpc: SdkRpc, signature: Signature, programAddress?: Address): Promise<EventWithContext[]>;
+export declare function collectEventsForAddress(rpc: SdkRpc, address: Address, options?: {
+    limit?: number;
+    before?: Signature;
+    until?: Signature;
+    programAddress?: Address;
+}): Promise<EventWithContext[]>;
+export declare function subscribeToPaymentEvents(rpcSubscriptions: RpcSubscriptions<SolanaRpcSubscriptionsApi>, callback: (event: EventWithContext) => void, options?: {
+    programAddress?: Address;
+    onError?: (error: unknown) => void;
+}): () => void;
+export declare function eventParticipants(event: PhygitalPaymentEvent): Address[];
+//# sourceMappingURL=events.d.ts.map

package/dist/core/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"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"}

package/dist/core/events.js

@@ -0,0 +1,258 @@
+import { sha256 } from "@noble/hashes/sha2.js";
+import { fixDecoderSize, getAddressDecoder, getBytesDecoder, getStructDecoder, getU32Decoder, getU64Decoder, getU8Decoder, } from "@solana/kit";
+import { PHYGITAL_PAYMENT_PROGRAM_ADDRESS } from "../generated/programs/phygitalPayment.js";
+import { base64UrlToBytes, toUint8Array } from "./bytes.js";
+export function eventDiscriminator(rustName) {
+    return sha256(new TextEncoder().encode(`event:${rustName}`)).slice(0, 8);
+}
+const address = getAddressDecoder();
+const u64 = getU64Decoder();
+const u32 = getU32Decoder();
+const u8 = getU8Decoder();
+const bytes32 = fixDecoderSize(getBytesDecoder(), 32);
+const EVENT_SPECS = [
+    {
+        type: "paymentCreated",
+        discriminator: eventDiscriminator("PaymentCreated"),
+        decoder: getStructDecoder([
+            ["payment", address],
+            ["payer", address],
+            ["merchant", address],
+            ["mint", address],
+            ["amount", u64],
+            ["issuedAt", u32],
+            ["captureAfter", u32],
+            ["arbiter", address],
+            ["reference", bytes32],
+        ]),
+        byteFields: ["reference"],
+    },
+    {
+        type: "paymentCaptured",
+        discriminator: eventDiscriminator("PaymentCaptured"),
+        decoder: getStructDecoder([
+            ["payment", address],
+            ["payer", address],
+            ["merchant", address],
+            ["amount", u64],
+        ]),
+        byteFields: [],
+    },
+    {
+        type: "paymentRefunded",
+        discriminator: eventDiscriminator("PaymentRefunded"),
+        decoder: getStructDecoder([
+            ["payment", address],
+            ["payer", address],
+            ["merchant", address],
+            ["refunded", u64],
+            ["remaining", u64],
+        ]),
+        byteFields: [],
+    },
+    {
+        type: "paymentDisputed",
+        discriminator: eventDiscriminator("PaymentDisputed"),
+        decoder: getStructDecoder([
+            ["payment", address],
+            ["payer", address],
+            ["merchant", address],
+            ["bondAmount", u64],
+            ["payerEvidenceHash", bytes32],
+        ]),
+        byteFields: ["payerEvidenceHash"],
+    },
+    {
+        type: "disputeResolved",
+        discriminator: eventDiscriminator("DisputeResolved"),
+        decoder: getStructDecoder([
+            ["payment", address],
+            ["payer", address],
+            ["merchant", address],
+            ["arbiter", address],
+            ["merchantAmount", u64],
+            ["payerAmount", u64],
+        ]),
+        byteFields: [],
+    },
+    {
+        type: "reserveChanged",
+        discriminator: eventDiscriminator("ReserveChanged"),
+        decoder: getStructDecoder([
+            ["paymentAccount", address],
+            ["owner", address],
+            ["mint", address],
+            ["reserveAmount", u64],
+            ["pendingReserveAmount", u64],
+            ["reserveEffectiveAt", u32],
+        ]),
+        byteFields: [],
+    },
+    {
+        type: "settledPaymentRefunded",
+        discriminator: eventDiscriminator("SettledPaymentRefunded"),
+        decoder: getStructDecoder([
+            ["payment", address],
+            ["reference", bytes32],
+            ["payer", address],
+            ["merchant", address],
+            ["mint", address],
+            ["amount", u64],
+        ]),
+        byteFields: ["reference"],
+    },
+    {
+        type: "paymentClosed",
+        discriminator: eventDiscriminator("PaymentClosed"),
+        decoder: getStructDecoder([
+            ["payment", address],
+            ["payer", address],
+            ["merchant", address],
+            ["reference", bytes32],
+            ["status", u8],
+        ]),
+        byteFields: ["reference"],
+    },
+];
+function discriminatorMatches(a, b) {
+    for (let i = 0; i < 8; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+export function decodeEventData(bytes) {
+    if (bytes.length < 8)
+        return null;
+    const disc = bytes.subarray(0, 8);
+    for (const spec of EVENT_SPECS) {
+        if (!discriminatorMatches(disc, spec.discriminator))
+            continue;
+        try {
+            const decoded = spec.decoder.decode(bytes.subarray(8));
+            for (const field of spec.byteFields) {
+                decoded[field] = toUint8Array(decoded[field]);
+            }
+            return { type: spec.type, data: decoded };
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+const PROGRAM_DATA_PREFIX = "Program data: ";
+const INVOKE_RE = /^Program (\w{32,44}) invoke \[\d+\]$/;
+const RESULT_RE = /^Program (\w{32,44}) (?:success|failed)/;
+export function decodeEventsFromLogs(logs, programAddress = PHYGITAL_PAYMENT_PROGRAM_ADDRESS) {
+    const events = [];
+    const stack = [];
+    for (const line of logs) {
+        const invoke = INVOKE_RE.exec(line);
+        if (invoke) {
+            stack.push(invoke[1]);
+            continue;
+        }
+        const result = RESULT_RE.exec(line);
+        if (result) {
+            if (stack[stack.length - 1] === result[1])
+                stack.pop();
+            continue;
+        }
+        if (!line.startsWith(PROGRAM_DATA_PREFIX))
+            continue;
+        if (stack[stack.length - 1] !== programAddress)
+            continue;
+        let payload;
+        try {
+            const base64 = line.slice(PROGRAM_DATA_PREFIX.length).trim();
+            payload = base64UrlToBytes(base64.replaceAll("+", "-").replaceAll("/", "_"));
+        }
+        catch {
+            continue;
+        }
+        const event = decodeEventData(payload);
+        if (event)
+            events.push(event);
+    }
+    return events;
+}
+export async function getEventsForSignature(rpc, signature, programAddress = PHYGITAL_PAYMENT_PROGRAM_ADDRESS) {
+    const tx = await rpc
+        .getTransaction(signature, {
+        maxSupportedTransactionVersion: 0,
+        encoding: "json",
+        commitment: "confirmed",
+    })
+        .send();
+    if (!tx || !tx.meta?.logMessages)
+        return [];
+    return decodeEventsFromLogs(tx.meta.logMessages, programAddress).map((event) => ({
+        event,
+        signature,
+        slot: tx.slot,
+        blockTime: tx.blockTime === null ? null : Number(tx.blockTime),
+    }));
+}
+export async function collectEventsForAddress(rpc, address, options = {}) {
+    const limit = options.limit ?? 50;
+    const programAddress = options.programAddress ?? PHYGITAL_PAYMENT_PROGRAM_ADDRESS;
+    const signatures = await rpc
+        .getSignaturesForAddress(address, {
+        limit,
+        before: options.before,
+        until: options.until,
+        commitment: "confirmed",
+    })
+        .send();
+    const results = await Promise.all(signatures
+        .filter((entry) => entry.err === null)
+        .map((entry) => getEventsForSignature(rpc, entry.signature, programAddress)));
+    return results.flat();
+}
+export function subscribeToPaymentEvents(rpcSubscriptions, callback, options = {}) {
+    const programAddress = options.programAddress ?? PHYGITAL_PAYMENT_PROGRAM_ADDRESS;
+    const abortController = new AbortController();
+    void (async () => {
+        try {
+            const notifications = await rpcSubscriptions
+                .logsNotifications({ mentions: [programAddress] }, { commitment: "confirmed" })
+                .subscribe({ abortSignal: abortController.signal });
+            for await (const notification of notifications) {
+                const { value, context } = notification;
+                if (value.err !== null)
+                    continue;
+                for (const event of decodeEventsFromLogs(value.logs ?? [], programAddress)) {
+                    callback({
+                        event,
+                        signature: value.signature,
+                        slot: context.slot,
+                        blockTime: null,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            if (!abortController.signal.aborted) {
+                options.onError?.(error);
+            }
+        }
+    })();
+    return () => abortController.abort();
+}
+export function eventParticipants(event) {
+    switch (event.type) {
+        case "reserveChanged":
+            return [event.data.paymentAccount, event.data.owner, event.data.mint];
+        case "disputeResolved":
+            return [
+                event.data.payment,
+                event.data.payer,
+                event.data.merchant,
+                event.data.arbiter,
+            ];
+        default:
+            return [event.data.payment, event.data.payer, event.data.merchant];
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"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"}

package/dist/core/evidence.d.ts

@@ -0,0 +1,3 @@
+export declare function hashEvidence(evidence: Uint8Array | string): Uint8Array;
+export declare const NO_EVIDENCE: Uint8Array;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/core/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/core/evidence.ts"],"names":[],"mappings":"AAaA,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,CAItE;AAGD,eAAO,MAAM,WAAW,EAAE,UAA+B,CAAC"}

package/dist/core/evidence.js

@@ -0,0 +1,7 @@
+import { sha256 } from "@noble/hashes/sha2.js";
+export function hashEvidence(evidence) {
+    const bytes = typeof evidence === "string" ? new TextEncoder().encode(evidence) : evidence;
+    return sha256(bytes);
+}
+export const NO_EVIDENCE = new Uint8Array(32);
+//# sourceMappingURL=evidence.js.map

package/dist/core/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../src/core/evidence.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM/C,MAAM,UAAU,YAAY,CAAC,QAA6B;IACxD,MAAM,KAAK,GACT,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/E,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAGD,MAAM,CAAC,MAAM,WAAW,GAAe,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC"}

package/dist/core/execution-plan.d.ts

@@ -0,0 +1,25 @@
+export type ExecutionPlan = {
+    mode: "immediate";
+} | {
+    mode: "deferred";
+    executeBy: number;
+};
+export interface ReserveState {
+    reserveAmount: bigint;
+    pendingReserveAmount: bigint;
+    reserveEffectiveAt: number;
+}
+export interface ConfigChangeState {
+    enablerEffectiveAt: number;
+    credentialEffectiveAt: number;
+    arbiterEffectiveAt: number;
+    tapLimitEffectiveAt: number;
+    pendingMaxTapAmount: bigint;
+}
+export interface ExposureState {
+    outstandingExposure: bigint;
+    freeEscrow: bigint;
+}
+export declare function computeExecutionPlan(account: ReserveState, amount: bigint, now?: number, exposure?: ExposureState, config?: ConfigChangeState): ExecutionPlan;
+export declare function clampExecuteBy(claimed: number, serverPlan: ExecutionPlan): number | null;
+//# sourceMappingURL=execution-plan.d.ts.map

package/dist/core/execution-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-plan.d.ts","sourceRoot":"","sources":["../../src/core/execution-plan.ts"],"names":[],"mappings":"AA0CA,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAOD,MAAM,WAAW,iBAAiB;IAEhC,kBAAkB,EAAE,MAAM,CAAC;IAE3B,qBAAqB,EAAE,MAAM,CAAC;IAE9B,kBAAkB,EAAE,MAAM,CAAC;IAE3B,mBAAmB,EAAE,MAAM,CAAC;IAE5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AA6BD,MAAM,WAAW,aAAa;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAAqB,EAC1B,QAAQ,CAAC,EAAE,aAAa,EACxB,MAAM,CAAC,EAAE,iBAAiB,GACzB,aAAa,CAgDf;AAOD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,MAAM,GAAG,IAAI,CAGf"}