sally-defi-ts-sdk 0.3.2

package/dist/client.js

@@ -0,0 +1,452 @@
+/**
+ * The one object users hold: {@link SallyClient}.
+ *
+ * Every read is a direct `eth_call` to the on-chain contracts through your RPC —
+ * no API, no subgraph / Graph Node, no backend in the data path.
+ *
+ * Reads work with just an RPC URL. Writes need a signer — pass a `privateKey`, a
+ * 12/24-word `mnemonic`, or an ethers `Wallet`/`HDNodeWallet`. To sign with your
+ * **own** wallet instead, pass only `address` (no key) and use the build/preview
+ * API: every action can return a fully-populated, ABI-decoded, simulated
+ * *unsigned* transaction you sign and broadcast yourself.
+ *
+ * Feature namespaces:
+ *
+ *     client.prices      USD / spot pricing + token safety
+ *     client.swap        quote + execute hybrid swaps (+ build/preview)
+ *     client.wallet      balances with live USD valuation
+ *     client.liquidity   add / remove / lock / harvest / positions
+ *     client.fees        referral + batch fee accounting
+ */
+import { Contract, HDNodeWallet, JsonRpcProvider, Network, Wallet, getAddress, } from "ethers";
+import * as deployment from "./deployment.js";
+import { SallyConfigError, SallyError, SallyRevert, wrapWeb3Error } from "./errors.js";
+import { SafetyConfig } from "./safety.js";
+import { Token } from "./token.js";
+import { TxPreview } from "./previews.js";
+import { Permit2 } from "./permit2.js";
+import { Prices } from "./modules/prices.js";
+import { Swap } from "./modules/swap.js";
+import { Wallet as WalletModule } from "./modules/wallet.js";
+import { Liquidity } from "./modules/liquidity.js";
+import { Fees } from "./modules/fees.js";
+// Process-wide nonce locks keyed by signer address, so concurrent sends from the
+// same account — even across different SallyClient instances — serialize.
+const _NONCE_LOCKS = new Map();
+function lockFor(address) {
+    if (address === null)
+        return new AsyncMutex(); // read-only client: lock unused
+    const key = address.toLowerCase();
+    let lock = _NONCE_LOCKS.get(key);
+    if (!lock) {
+        lock = new AsyncMutex();
+        _NONCE_LOCKS.set(key, lock);
+    }
+    return lock;
+}
+/** Minimal async mutex: serialize an async critical section. */
+class AsyncMutex {
+    _chain = Promise.resolve();
+    async run(fn) {
+        const prev = this._chain;
+        let release;
+        this._chain = new Promise((res) => (release = res));
+        await prev;
+        try {
+            return await fn();
+        }
+        finally {
+            release();
+        }
+    }
+}
+export class SallyClient {
+    chainKey;
+    chainId;
+    safety;
+    privateRpcUrl;
+    _privateW3 = null;
+    w3;
+    gasMultiplier;
+    account = null;
+    _sender = null;
+    _sendLock;
+    addresses;
+    // lazy namespace + contract caches
+    _cache = {};
+    constructor(chain = "base", rpcUrl, opts = {}) {
+        this.chainKey = deployment.normalizeChain(chain);
+        this.chainId = deployment.chainId(this.chainKey);
+        this.safety = opts.safety ?? new SafetyConfig();
+        this.privateRpcUrl = opts.privateRpcUrl ?? process.env.SALLY_PRIVATE_RPC_URL ?? null;
+        this.gasMultiplier = opts.gasMultiplier ?? 1.25;
+        rpcUrl = rpcUrl ?? process.env.SALLY_RPC_URL ?? null;
+        if (!rpcUrl) {
+            throw new SallyConfigError("No rpcUrl given and SALLY_RPC_URL is unset. " +
+                "Pass rpcUrl='https://…' or set the env var.");
+        }
+        // Static network so construction never triggers a chainId auto-detect call.
+        const network = Network.from(this.chainId);
+        this.w3 = new JsonRpcProvider(rpcUrl, network, { staticNetwork: network });
+        // POA: ethers handles non-standard extraData natively; flag kept for parity.
+        void (opts.poa ?? this.chainKey === "bsc");
+        // Signer resolution: account > privateKey > mnemonic. `address` (no key)
+        // enables sign-externally mode.
+        const key = opts.privateKey ?? process.env.SALLY_PRIVATE_KEY ?? null;
+        const phrase = opts.mnemonic ?? process.env.SALLY_MNEMONIC ?? null;
+        if (opts.account != null) {
+            this.account = opts.account;
+        }
+        else if (key) {
+            this.account = new Wallet(key);
+        }
+        else if (phrase) {
+            const idx = opts.accountIndex ?? 0;
+            this.account = HDNodeWallet.fromPhrase(phrase, undefined, `m/44'/60'/0'/0/${idx}`);
+        }
+        this._sender = this.account
+            ? this._accountAddress(this.account)
+            : opts.address
+                ? getAddress(opts.address)
+                : null;
+        this._sendLock = lockFor(this._sender);
+        this.addresses = Object.fromEntries(Object.entries(deployment.addresses(this.chainKey)).map(([k, v]) => [
+            k,
+            v.startsWith("0x") ? getAddress(v) : v,
+        ]));
+    }
+    _accountAddress(acc) {
+        // Wallet/HDNodeWallet expose `.address` synchronously.
+        return getAddress(acc.address);
+    }
+    // ------------------------------------------------------------------ //
+    // Connection / identity
+    // ------------------------------------------------------------------ //
+    async isConnected() {
+        try {
+            await this.w3.getBlockNumber();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Sender address — from the signer, or the keyless `address` mode. */
+    get address() {
+        return this._sender;
+    }
+    get canSign() {
+        return this.account !== null;
+    }
+    /** The sender address (needs a signer OR keyless `address`). */
+    requireAddress() {
+        if (!this._sender) {
+            throw new SallyConfigError("This action needs a sender. Create the client with privateKey=…, " +
+                "mnemonic=…, or address='0x…' (sign-externally mode).");
+        }
+        return this._sender;
+    }
+    /** The local signing account (needs a key/mnemonic, not just `address`). */
+    requireSigner() {
+        if (this.account === null) {
+            throw new SallyConfigError("This action signs a transaction and needs a key. Pass privateKey=… " +
+                "or mnemonic=…, or use buildOnly=true / .preview() to sign externally.");
+        }
+        return this.account;
+    }
+    /** Return a new client on the same RPC/config but with a different signer. */
+    withAccount(privateKey) {
+        const c = Object.create(SallyClient.prototype);
+        Object.assign(c, this);
+        c.account = new Wallet(privateKey);
+        c._sender = c._accountAddress(c.account);
+        c._sendLock = lockFor(c._sender);
+        c._privateW3 = null;
+        c._cache = {};
+        return c;
+    }
+    // ------------------------------------------------------------------ //
+    // Contracts (proxy-fallback aware)
+    // ------------------------------------------------------------------ //
+    _contract(address, component) {
+        return new Contract(getAddress(address), deployment.abi(this.chainKey, component), this.w3);
+    }
+    _cached(key, make) {
+        if (!(key in this._cache))
+            this._cache[key] = make();
+        return this._cache[key];
+    }
+    get swapContract() {
+        return this._cached("swapContract", () => this._contract(this.addresses["swap"], "swap"));
+    }
+    get liquidityContract() {
+        return this._cached("liquidityContract", () => this._contract(this.addresses["liquidity"], "liquidity"));
+    }
+    /** Lens ABI bound to the **swap proxy** (v2.0.2 read-fallback). */
+    get lensContract() {
+        return this._cached("lensContract", () => this._contract(this.addresses["lens"], "lens"));
+    }
+    /** Sidecar ABI bound to the **liq proxy** (v2.0.2 read-fallback). */
+    get sidecarContract() {
+        return this._cached("sidecarContract", () => this._contract(this.addresses["sidecar"], "sidecar"));
+    }
+    token(address) {
+        return new Token(this, address);
+    }
+    // ------------------------------------------------------------------ //
+    // Call / simulate / send
+    // ------------------------------------------------------------------ //
+    /** Execute a read (`eth_call`). Decodes reverts into SallyRevert. */
+    async call(fn, args = [], opts = {}) {
+        const overrides = {};
+        if (opts.value)
+            overrides.value = opts.value;
+        const sender = opts.sender ?? this.address;
+        if (sender)
+            overrides.from = sender;
+        try {
+            return await fn.staticCall(...args, overrides);
+        }
+        catch (exc) {
+            throw wrapWeb3Error(this.chainKey, exc);
+        }
+    }
+    /** Dry-run a state-changing call without sending (revert-safe preview). */
+    async simulate(fn, args = [], opts = {}) {
+        return this.call(fn, args, { value: opts.value, sender: this.address });
+    }
+    async estimateGas(fn, args = [], opts = {}) {
+        const overrides = { from: this.requireAddress() };
+        if (opts.value)
+            overrides.value = opts.value;
+        try {
+            return BigInt(await fn.estimateGas(...args, overrides));
+        }
+        catch (exc) {
+            throw wrapWeb3Error(this.chainKey, exc);
+        }
+    }
+    /** Build a fully-populated, signable EIP-1559 transaction. */
+    async buildTx(fn, args = [], opts = {}) {
+        const sender = this.requireAddress();
+        const overrides = { from: sender };
+        if (opts.value)
+            overrides.value = opts.value;
+        let tx;
+        try {
+            tx = { ...(await fn.populateTransaction(...args, overrides)) };
+        }
+        catch (exc) {
+            throw wrapWeb3Error(this.chainKey, exc);
+        }
+        tx.nonce = await this.w3.getTransactionCount(sender, "pending");
+        tx.chainId = this.chainId;
+        if (opts.value)
+            tx.value = opts.value;
+        // EIP-1559 fees (fall back to legacy gasPrice on chains without baseFee).
+        const latest = await this.w3.getBlock("latest");
+        const feeData = await this.w3.getFeeData();
+        if (latest && latest.baseFeePerGas != null) {
+            let tip = feeData.maxPriorityFeePerGas;
+            if (tip == null)
+                tip = 1000000000n; // 1 gwei fallback
+            tx.maxPriorityFeePerGas = tip;
+            tx.maxFeePerGas = tip + 2n * latest.baseFeePerGas;
+            tx.type = 2;
+            delete tx.gasPrice;
+        }
+        else {
+            tx.gasPrice = feeData.gasPrice ?? 0n;
+            tx.type = 0;
+        }
+        // Gas estimate + safety buffer (state-dependent txs can cost more at
+        // execution than at estimation). Explicit `gas` overrides below.
+        let gas = opts.gas ?? null;
+        if (gas === null) {
+            gas = await this.estimateGas(fn, args, { value: opts.value });
+            if (this.gasMultiplier && this.gasMultiplier !== 1.0) {
+                gas = (gas * BigInt(Math.round(this.gasMultiplier * 1000))) / 1000n;
+            }
+        }
+        tx.gasLimit = gas;
+        delete tx.gas;
+        return tx;
+    }
+    /**
+     * Build -> sign -> send a transaction.
+     *
+     * With `buildOnly=true` returns the fully-populated **unsigned** tx (no key
+     * required — only a sender `address`); sign and broadcast it with your own
+     * wallet. Otherwise: with `wait=true` (default) returns the mined receipt and
+     * raises SallyRevert on a failed (status 0) tx; with `wait=false` returns the
+     * tx hash. `simulate=true` does a cheap `eth_call` first so reverts surface
+     * *before* you spend gas.
+     *
+     * `private` broadcasts through `privateRpcUrl` (a private mempool / MEV-relay).
+     * `timeout` (seconds) bounds the receipt wait.
+     */
+    async send(fn, args = [], opts = {}) {
+        const value = opts.value ?? 0n;
+        const wait = opts.wait ?? true;
+        const simulate = opts.simulate ?? true;
+        const timeout = opts.timeout ?? 180;
+        if (simulate) {
+            await this.simulate(fn, args, { value });
+        }
+        if (opts.buildOnly) {
+            return this.buildTx(fn, args, { value, gas: opts.gas ?? null });
+        }
+        const account = this.requireSigner();
+        const usePrivate = opts.private == null ? this.privateRpcUrl !== null : opts.private;
+        // Hold the per-signer lock across nonce-fetch → broadcast so concurrent sends
+        // from one account get distinct, sequential nonces.
+        const txh = await this._sendLock.run(async () => {
+            const tx = await this.buildTx(fn, args, { value, gas: opts.gas ?? null });
+            const raw = await account.signTransaction(tx);
+            let hash;
+            if (usePrivate) {
+                hash = await this._broadcastPrivate(raw);
+            }
+            else {
+                const resp = await this.w3.broadcastTransaction(raw);
+                hash = resp.hash;
+            }
+            return hash;
+        });
+        if (!wait)
+            return txh;
+        let receipt;
+        try {
+            receipt = await this.w3.waitForTransaction(txh, 1, timeout * 1000);
+        }
+        catch (exc) {
+            receipt = null;
+        }
+        if (receipt === null) {
+            const where = usePrivate ? "private relay" : "public mempool";
+            throw new SallyError(`tx ${txh} not mined within ${timeout}s via ${where}. It may have been ` +
+                `dropped/not included — check the hash before resubmitting.`);
+        }
+        if (receipt.status !== 1) {
+            // A receipt carries no revert data; replay the tx at its block to recover it.
+            throw await this._decodeFailedTx(txh, receipt);
+        }
+        return receipt;
+    }
+    async _decodeFailedTx(txh, receipt) {
+        try {
+            const tx = await this.w3.getTransaction(txh);
+            if (tx) {
+                const callTx = {
+                    from: tx.from,
+                    to: tx.to,
+                    data: tx.data,
+                    value: tx.value,
+                    gasLimit: tx.gasLimit,
+                };
+                await this.w3.call({ ...callTx, blockTag: receipt.blockNumber - 1 });
+            }
+        }
+        catch (exc) {
+            const err = wrapWeb3Error(this.chainKey, exc);
+            return new SallyError(`tx ${txh} reverted on-chain: ${err.toString()}`);
+        }
+        return new SallyRevert("Error", [], null, `tx ${txh} reverted on-chain`);
+    }
+    // ------------------------------------------------------------------ //
+    // Preview (sign-externally): build + simulate + ABI-decode, no key
+    // ------------------------------------------------------------------ //
+    /** ABI-decode a contract call into `[functionName, { arg: value }]`. */
+    decodeCall(fn, args = []) {
+        const fragment = fn.fragment ?? {};
+        const inputs = fragment.inputs ?? [];
+        const out = {};
+        inputs.forEach((inp, n) => {
+            out[inp.name || `arg${n}`] = args[n];
+        });
+        return [fragment.name ?? "?", out];
+    }
+    /**
+     * Build an unsigned tx + simulate + decode — see it before you broadcast.
+     *
+     * Returns a {@link TxPreview} with the unsigned transaction (sign it with your
+     * own wallet), the decoded function/args, the simulated `eth_call` result, the
+     * decoded revert reason if it would fail, and the gas estimate. Needs only a
+     * sender `address` — no key.
+     */
+    async preview(fn, args = [], opts = {}) {
+        const value = opts.value ?? 0n;
+        const sender = this.requireAddress();
+        const [name, decodedArgs] = this.decodeCall(fn, args);
+        let simulated = null;
+        let revert = null;
+        let gas = null;
+        let to = this.addresses["swap"];
+        try {
+            simulated = await this.call(fn, args, { value, sender });
+            gas = await this.estimateGas(fn, args, { value });
+        }
+        catch (exc) {
+            if (exc instanceof SallyConfigError)
+                throw exc;
+            revert = String(exc); // Python: str(exc) — SallyRevert renders "<name>: <detail>"
+        }
+        let unsigned = {};
+        if (revert === null) {
+            unsigned = await this.buildTx(fn, args, { value });
+            if (unsigned.to)
+                to = unsigned.to;
+        }
+        return new TxPreview({
+            unsignedTx: unsigned,
+            sender,
+            to: String(to),
+            function: name,
+            args: decodedArgs,
+            value,
+            simulatedReturn: simulated,
+            revert,
+            gas,
+        });
+    }
+    /** POST the raw tx to the private relay; return the tx hash. */
+    async _broadcastPrivate(rawTx) {
+        if (!this.privateRpcUrl) {
+            throw new SallyConfigError("private=true but no privateRpcUrl configured. Pass " +
+                "new SallyClient(..., { privateRpcUrl: 'https://rpc.flashbots.net/fast' }).");
+        }
+        if (this._privateW3 === null) {
+            this._privateW3 = new JsonRpcProvider(this.privateRpcUrl, Network.from(this.chainId), {
+                staticNetwork: Network.from(this.chainId),
+            });
+        }
+        const resp = await this._privateW3.broadcastTransaction(rawTx);
+        return resp.hash;
+    }
+    // ------------------------------------------------------------------ //
+    // Namespaces (lazy)
+    // ------------------------------------------------------------------ //
+    get prices() {
+        return this._cached("prices", () => new Prices(this));
+    }
+    get swap() {
+        return this._cached("swap", () => new Swap(this));
+    }
+    get wallet() {
+        return this._cached("wallet", () => new WalletModule(this));
+    }
+    get liquidity() {
+        return this._cached("liquidity", () => new Liquidity(this));
+    }
+    get fees() {
+        return this._cached("fees", () => new Fees(this));
+    }
+    get permit2() {
+        return this._cached("permit2", () => new Permit2(this));
+    }
+    toString() {
+        const who = this.address ?? "read-only";
+        return `<SallyClient chain=${this.chainKey} id=${this.chainId} signer=${who}>`;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Well-known token addresses, handy for examples and tests.
+ *
+ * These are convenience constants only — the SDK itself never depends on them.
+ */
+export declare const Base: {
+    readonly WETH: "0x4200000000000000000000000000000000000006";
+    readonly USDC: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+    readonly USDbC: "0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA";
+    readonly DAI: "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb";
+    readonly cbBTC: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf";
+};
+export declare const Bsc: {
+    readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+    readonly USDT: "0x55d398326f99059fF775485246999027B3197955";
+    readonly USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
+    readonly CAKE: "0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82";
+};
+export declare const NATIVE_TOKEN = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/**
+ * Known private-mempool / MEV-protection relay RPCs.
+ *
+ * Pass one as `new SallyClient(..., { privateRpcUrl: PrivateRelays.X })`.
+ * Flashbots Protect is Ethereum-L1 only; BSC has 48.club / bloXroute; Base's
+ * sequencer is centralized (limited public-mempool MEV), so a private relay
+ * matters most on L1 — verify your chain actually has one before relying on it.
+ */
+export declare const PrivateRelays: {
+    readonly FLASHBOTS_FAST: "https://rpc.flashbots.net/fast";
+    readonly FLASHBOTS: "https://rpc.flashbots.net";
+    readonly MEVBLOCKER: "https://rpc.mevblocker.io";
+    readonly BSC_48CLUB: "https://rpc.48.club";
+    readonly BSC_BLOXROUTE: "https://bsc.rpc.blxrbdn.com";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,IAAI;;;;;;CAMP,CAAC;AAGX,eAAO,MAAM,GAAG;;;;;CAKN,CAAC;AAEX,eAAO,MAAM,YAAY,+CAAS,CAAC;AACnC,eAAO,MAAM,YAAY,+CAAO,CAAC;AAEjC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,39 @@
+/**
+ * Well-known token addresses, handy for examples and tests.
+ *
+ * These are convenience constants only — the SDK itself never depends on them.
+ */
+import { NATIVE, ZERO } from "./token.js";
+// Base (chain 8453)
+export const Base = {
+    WETH: "0x4200000000000000000000000000000000000006",
+    USDC: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    USDbC: "0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA",
+    DAI: "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb",
+    cbBTC: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
+};
+// BSC (chain 56)
+export const Bsc = {
+    WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c",
+    USDT: "0x55d398326f99059fF775485246999027B3197955",
+    USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+    CAKE: "0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82",
+};
+export const NATIVE_TOKEN = NATIVE;
+export const ZERO_ADDRESS = ZERO;
+/**
+ * Known private-mempool / MEV-protection relay RPCs.
+ *
+ * Pass one as `new SallyClient(..., { privateRpcUrl: PrivateRelays.X })`.
+ * Flashbots Protect is Ethereum-L1 only; BSC has 48.club / bloXroute; Base's
+ * sequencer is centralized (limited public-mempool MEV), so a private relay
+ * matters most on L1 — verify your chain actually has one before relying on it.
+ */
+export const PrivateRelays = {
+    FLASHBOTS_FAST: "https://rpc.flashbots.net/fast", // ETH mainnet
+    FLASHBOTS: "https://rpc.flashbots.net", // ETH mainnet
+    MEVBLOCKER: "https://rpc.mevblocker.io", // ETH mainnet
+    BSC_48CLUB: "https://rpc.48.club", // BSC
+    BSC_BLOXROUTE: "https://bsc.rpc.blxrbdn.com", // BSC
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE1C,oBAAoB;AACpB,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,4CAA4C;IAClD,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,4CAA4C;IACnD,GAAG,EAAE,4CAA4C;IACjD,KAAK,EAAE,4CAA4C;CAC3C,CAAC;AAEX,iBAAiB;AACjB,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,IAAI,EAAE,4CAA4C;IAClD,IAAI,EAAE,4CAA4C;IAClD,IAAI,EAAE,4CAA4C;IAClD,IAAI,EAAE,4CAA4C;CAC1C,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,cAAc,EAAE,gCAAgC,EAAE,cAAc;IAChE,SAAS,EAAE,2BAA2B,EAAE,cAAc;IACtD,UAAU,EAAE,2BAA2B,EAAE,cAAc;IACvD,UAAU,EAAE,qBAAqB,EAAE,MAAM;IACzC,aAAa,EAAE,6BAA6B,EAAE,MAAM;CAC5C,CAAC"}