dappily-agent-kit 0.1.0 → 0.4.0

package/README.md

@@ -1,24 +1,51 @@
 # 🦞 Dappily Agent Kit
 
-**Solana Agent Kit-style actions for Hedera — HTS tokens, NFTs, transfers, and more.**
+**AI agent toolkit for Hedera — 15 actions + self-forging action generator.**
 
-Give any AI agent the ability to interact with the Hedera network. Inspired by [solana-agent-kit](https://github.com/sendaifun/solana-agent-kit).
+Give any AI agent the ability to interact with the Hedera network. Define actions as JSON specs, generate working TypeScript automatically.
 
-## Proven on Testnet
+## What's New in 0.3.0: The Forge
 
-Every action has been tested with real transactions on Hedera testnet — not just schema validation, but actual on-chain execution with verified receipts:
+The kit now includes a **deterministic action generator**. Write a JSON spec → get a working, type-safe Hedera action with zero manual code.
 
-| Action | Testnet Proof |
-|--------|---------------|
-| GET_BALANCE | ✅ 999 ℏ queried |
-| HBAR_TRANSFER | ✅ Receipt: SUCCESS |
-| CREATE_TOKEN | ✅ Token `0.0.7932264` created |
-| MINT_TOKEN | ✅ Supply 10000 → 15000 |
-| BURN_TOKEN | ✅ Supply 15000 → 14000 |
-| TRANSFER_TOKEN | ✅ 100 tokens moved |
-| CREATE_NFT_COLLECTION | ✅ Collection `0.0.7932266` created |
-| MINT_NFT | ✅ Serials [1, 2, 3] returned |
-| BURN_NFT | ✅ Serial #3 destroyed |
+```typescript
+import { validateSpec, generateAction } from "dappily-agent-kit";
+import * as fs from "fs";
+
+// Load a spec
+const spec = JSON.parse(fs.readFileSync("my_action.spec.json", "utf-8"));
+
+// Validate against the schema
+const result = validateSpec(spec);
+if (!result.ok) throw new Error(result.errors.join("\n"));
+
+// Generate TypeScript code
+const code = generateAction(result.spec);
+fs.writeFileSync("src/actions/my_action.ts", code);
+// → Compiles. Runs on testnet. Zero edits needed.
+```
+
+**Proven on testnet:** The generator produces actions that compile with `tsc --strict` and execute real transactions on Hedera testnet — token creation, HBAR transfers, consensus queries — all without a single manual fix.
+
+## Testnet-Verified Actions
+
+| # | Action | Domain | Testnet Proof |
+|---|--------|--------|---------------|
+| 1 | `GET_BALANCE` | Core | ✅ Live query |
+| 2 | `HBAR_TRANSFER` | Core | ✅ Receipt: SUCCESS |
+| 3 | `CREATE_TOKEN` | HTS Fungible | ✅ Token created |
+| 4 | `ASSOCIATE_TOKEN` | HTS Fungible | ✅ |
+| 5 | `TRANSFER_TOKEN` | HTS Fungible | ✅ |
+| 6 | `MINT_TOKEN` | HTS Fungible | ✅ Supply verified |
+| 7 | `BURN_TOKEN` | HTS Fungible | ✅ Supply verified |
+| 8 | `CREATE_NFT_COLLECTION` | HTS NFT | ✅ Collection created |
+| 9 | `MINT_NFT` | HTS NFT | ✅ Serials [1,2,3] |
+| 10 | `TRANSFER_NFT` | HTS NFT | ✅ |
+| 11 | `BURN_NFT` | HTS NFT | ✅ Serial destroyed |
+| 12 | `CREATE_TOPIC` | HCS | ✅ Topic created |
+| 13 | `SUBMIT_MESSAGE` | HCS | ✅ 3 messages, seq verified |
+| 14 | `GET_TOPIC_INFO` | HCS | ✅ Memo + seq + keys |
+| 15 | `DELETE_TOPIC` | HCS | ✅ Deleted + verified |
 
 ## Quickstart
 
@@ -29,159 +56,137 @@ npm install dappily-agent-kit @hashgraph/sdk
 ```typescript
 import { HederaAgentKit, getBalanceAction, createTokenAction } from "dappily-agent-kit";
 
-// Initialize with your Hedera credentials
-const agent = new HederaAgentKit(
-  "0.0.YOUR_ACCOUNT",
-  "YOUR_PRIVATE_KEY",
-  "testnet" // or "mainnet"
-);
+const agent = new HederaAgentKit("0.0.YOUR_ACCOUNT", "YOUR_KEY", "testnet");
 
 // Check balance
-const balance = await getBalanceAction.handler(agent, {});
-if (balance.ok) {
-  console.log(balance.data.hbarBalance); // "150.5 ℏ"
-}
+const bal = await getBalanceAction.handler(agent, {});
+if (bal.ok) console.log(bal.data.hbarBalance);
 
 // Create a token
 const token = await createTokenAction.handler(agent, {
-  name: "My Token",
-  symbol: "MTK",
-  initialSupply: 1000000,
-  decimals: 2,
+  name: "My Token", symbol: "MTK", initialSupply: 1000000, decimals: 2,
 });
-if (token.ok) {
-  console.log(token.data.tokenId); // "0.0.XXXXX"
-}
+if (token.ok) console.log(token.data.tokenId);
 ```
 
-## Actions
+## Standardized Output
 
-### Core
+Every action returns:
 
-| Action | Input | Description |
-|--------|-------|-------------|
-| `GET_BALANCE` | `{ accountId?: string }` | Get HBAR + token balances. Defaults to agent's account. |
-| `HBAR_TRANSFER` | `{ to, amount, memo? }` | Send HBAR to another account. |
+```typescript
+// Success
+{ ok: true, summary: "...", txId: "...", receipt: { status: "SUCCESS" }, data: { ... } }
 
-### Fungible Tokens (HTS)
+// Failure
+{ ok: false, error: "INSUFFICIENT_PAYER_BALANCE", details: "..." }
+```
 
-| Action | Input | Description |
-|--------|-------|-------------|
-| `CREATE_TOKEN` | `{ name, symbol, initialSupply, decimals?, memo? }` | Create a new fungible token. |
-| `ASSOCIATE_TOKEN` | `{ tokenId, accountId?, accountPrivateKey? }` | Associate a token with an account. |
-| `TRANSFER_TOKEN` | `{ tokenId, to, amount, memo? }` | Transfer fungible tokens. Pre-flight association check. |
-| `MINT_TOKEN` | `{ tokenId, amount, supplyPrivateKey? }` | Mint additional supply. |
-| `BURN_TOKEN` | `{ tokenId, amount, supplyPrivateKey? }` | Burn supply (irreversible). |
+## The Forge: Self-Forging Actions
 
-### NFTs (HTS)
+The Forge is a deterministic code generator that turns JSON specs into working Hedera actions.
 
-| Action | Input | Description |
-|--------|-------|-------------|
-| `CREATE_NFT_COLLECTION` | `{ name, symbol, maxSupply?, memo? }` | Create an NFT collection. |
-| `MINT_NFT` | `{ tokenId, metadata: string[], supplyPrivateKey? }` | Mint NFTs with base64 metadata. Returns serial numbers. |
-| `TRANSFER_NFT` | `{ tokenId, serial, to, senderPrivateKey? }` | Transfer an NFT. Pre-flight association check. |
-| `BURN_NFT` | `{ tokenId, serial, supplyPrivateKey? }` | Burn an NFT (irreversible). |
+### How It Works
 
-## Standardized Output
+1. **Spec** — A JSON file describing the action: inputs, SDK methods, transforms, error maps
+2. **Validate** — Zod schema ensures the spec is machine-correct
+3. **Generate** — Deterministic template fill produces TypeScript code
+4. **Compile** — `tsc --strict` verifies type safety
+5. **Test** — Run against Hedera testnet to verify real execution
 
-Every action returns the same shape:
+### Spec Format (v4)
 
-```typescript
-// Success
+```json
 {
-  ok: true,
-  summary: "Sent 10 HBAR to 0.0.12345",
-  txId: "0.0.98765@1700000000.000000000",
-  receipt: { status: "SUCCESS" },
-  data: { /* action-specific */ }
+  "specVersion": 4,
+  "name": "MY_ACTION",
+  "category": "fungible",
+  "risk": "write",
+  "costTier": "medium",
+  "hedera": {
+    "sdkClass": "TokenCreateTransaction",
+    "sdkImports": ["TokenCreateTransaction", "Status"],
+    "networkCallType": "transaction"
+  },
+  "sdkMethods": [
+    { "method": "setTokenName", "args": [{ "from": "input.name" }] }
+  ],
+  "inputs": [
+    { "name": "name", "type": "string", "required": true, "describe": "Token name" }
+  ],
+  "successData": [...],
+  "errorMap": [...]
 }
+```
 
-// Failure
-{
-  ok: false,
-  error: "INSUFFICIENT_PAYER_BALANCE",
-  details: "The sending account does not have enough HBAR."
-}
+### CLI
+
+```bash
+# Validate all specs
+npm run forge:validate
+
+# Generate an action from a spec
+npm run forge:generate -- specs/create_token.spec.json output.ts
 ```
 
-Error codes are mapped from Hedera's native codes to human-readable messages. Pre-flight checks (like association verification) prevent wasted transactions.
+### 15 Reference Specs
+
+The kit includes specs for all 15 built-in actions in `src/forge/specs/`. These serve as the pattern library — examples of every structural pattern:
+
+- **Queries** (free, no signing): `get_balance`, `get_topic_info`
+- **Simple transactions**: `create_token`, `create_topic`, `delete_topic`, `mint_token`, `burn_token`, `associate_token`, `mint_nft`, `burn_nft`, `submit_message`, `create_nft_collection`
+- **Multi-arg transfers**: `hbar_transfer`, `transfer_token`, `transfer_nft`
 
 ## Action Discovery
 
 ```typescript
 import { actions, getActionByName, findActionBySimile } from "dappily-agent-kit";
 
-// List all actions
-actions.forEach(a => console.log(a.name, a.description));
-
-// Lookup by name
-const action = getActionByName("HBAR_TRANSFER");
-
-// Fuzzy match (for AI agents)
-const match = findActionBySimile("send some hbar");
-// → hbarTransferAction
+actions.forEach(a => console.log(a.name));
+getActionByName("HBAR_TRANSFER");
+findActionBySimile("send some hbar"); // → hbarTransferAction
 ```
 
 ## Examples
 
-See the [`examples/`](./examples) directory:
+See [`examples/`](./examples):
 
-- **`balance.ts`** — Check account balance
-- **`fungible-lifecycle.ts`** — Create → Mint → Transfer → Burn
-- **`nft-lifecycle.ts`** — Create collection → Mint NFTs → Burn
-
-```bash
-OPERATOR_ID=0.0.XXXXX OPERATOR_KEY=302e... npx ts-node examples/balance.ts
-```
+- `balance.ts` — Check account balance
+- `fungible-lifecycle.ts` — Create → Mint → Transfer → Burn
+- `nft-lifecycle.ts` — Create collection → Mint → Burn
+- `hcs-lifecycle.ts` — Create topic → Submit messages → Query → Delete
 
 ## Security
 
-⚠️ **Private keys in action inputs** are supported for development and testing. For production:
-
-- Use environment variables or a vault for key storage
-- Never log or persist private keys
-- Plan to integrate wallet signing (HashPack / WalletConnect) for third-party accounts
-- The `accountPrivateKey` and `supplyPrivateKey` fields will be replaced with a signing interface in a future version
+⚠️ Private keys in action inputs are supported for **development/testing only**. For production, use environment variables or wallet signing.
 
 ## Architecture
 
 ```
 dappily-agent-kit/
 ├── src/
-│   ├── index.ts              # Public API surface
-│   ├── agent/index.ts        # HederaAgentKit (client + operator)
-│   ├── actions/
-│   │   ├── index.ts          # Registry + lookup helpers
-│   │   ├── get_balance.ts    # GET_BALANCE
-│   │   ├── transfer.ts       # HBAR_TRANSFER
-│   │   ├── create_token.ts   # CREATE_TOKEN
-│   │   ├── associate_token.ts
-│   │   ├── transfer_token.ts
-│   │   ├── mint_token.ts
-│   │   ├── burn_token.ts
-│   │   ├── create_nft_collection.ts
-│   │   ├── mint_nft.ts
-│   │   ├── transfer_nft.ts
-│   │   └── burn_nft.ts
-│   └── types/action.ts       # ActionResult, Action, etc.
+│   ├── index.ts              # Public API
+│   ├── agent/                # HederaAgentKit
+│   ├── actions/              # 15 built-in actions
+│   ├── types/                # ActionResult types
+│   └── forge/                # Self-Forging system
+│       ├── actionSpec.ts     # Spec schema (Zod, v4)
+│       ├── generator.ts      # Deterministic code generator
+│       └── specs/            # 15 reference specs
 ├── examples/
-│   ├── balance.ts
-│   ├── fungible-lifecycle.ts
-│   └── nft-lifecycle.ts
-├── dist/                     # Built output (CJS + types)
-├── package.json
-├── tsconfig.build.json
-└── LICENSE
+├── dist/
+└── package.json
 ```
 
 ## Roadmap
 
-- [ ] HCS (Hedera Consensus Service) — topic create/submit
-- [ ] Mirror Node queries — token info, NFT metadata, transaction history
-- [ ] Wallet signing interface (replace private key inputs)
-- [ ] Smart contract deployment + invocation
-- [ ] Scheduled transactions
-- [ ] Multi-sig support
+- [x] 15 actions across HTS, NFT, HCS — all testnet-verified
+- [x] Deterministic action generator (Forge)
+- [x] 15 reference specs (v4 format)
+- [ ] Sandbox runner (automated generate → compile → testnet)
+- [ ] Prompt → Spec (LLM generates specs, generator does the rest)
+- [ ] Mirror Node queries
+- [ ] Framework adapters (Vercel AI, LangChain, MCP)
+- [ ] Wallet signing interface
 
 ## License
 

package/dist/actions/_sandbox_hbar_transfer.d.ts

@@ -0,0 +1,4 @@
+import { Action } from "../types/action";
+declare const hbarTransferAction: Action;
+export default hbarTransferAction;
+//# sourceMappingURL=_sandbox_hbar_transfer.d.ts.map

package/dist/actions/_sandbox_hbar_transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_sandbox_hbar_transfer.d.ts","sourceRoot":"","sources":["../../src/actions/_sandbox_hbar_transfer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AAQvD,QAAA,MAAM,kBAAkB,EAAE,MA0DzB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/actions/_sandbox_hbar_transfer.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const sdk_1 = require("@hashgraph/sdk");
+const hbarTransferAction = {
+    name: "HBAR_TRANSFER",
+    similes: ["send hbar", "pay hbar", "transfer hbar", "send money", "transfer funds", "tip hbar"],
+    description: "Send HBAR (native cryptocurrency) to another Hedera account.",
+    examples: [[]],
+    schema: zod_1.z.object({
+        to: zod_1.z.string().regex(/^\d+\.\d+\.\d+$/, "Invalid format").describe("The recipient's Hedera Account ID"),
+        amount: zod_1.z.number().min(0).describe("Amount of HBAR to send"),
+        memo: zod_1.z.string().max(100).optional().describe("Optional memo"),
+    }),
+    requiresConfirmation: true,
+    simulate: async (agent, input) => {
+        return {
+            summary: `Send HBAR (native cryptocurrency) to another Hedera account`,
+            estimatedFeeHbar: 0.0001,
+            warnings: [],
+        };
+    },
+    handler: async (agent, input) => {
+        try {
+            const tx = new sdk_1.TransferTransaction();
+            tx.addHbarTransfer(agent.accountId, new sdk_1.Hbar(input.amount).negated());
+            tx.addHbarTransfer(sdk_1.AccountId.fromString(input.to), new sdk_1.Hbar(input.amount));
+            if (input.memo) {
+                tx.setTransactionMemo(input.memo);
+            }
+            const response = await tx.execute(agent.client);
+            const receipt = await response.getReceipt(agent.client);
+            if (receipt.status !== sdk_1.Status.Success) {
+                return { ok: false, error: receipt.status.toString(), details: `HBAR_TRANSFER failed: ${receipt.status.toString()}` };
+            }
+            const txId = response.transactionId.toString();
+            return {
+                ok: true,
+                summary: "Send HBAR (native cryptocurrency) to another Hedera account",
+                txId,
+                receipt: { status: receipt.status.toString() },
+                data: {
+                    from: agent.accountId.toString(),
+                    to: input.to ?? null,
+                    amount: input.amount ?? null,
+                    memo: input.memo ?? null,
+                    explorerUrl: agent.getExplorerUrl(txId),
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const knownErrors = {
+                "INSUFFICIENT_PAYER_BALANCE": "Not enough HBAR.",
+                "INVALID_ACCOUNT_ID": "Recipient does not exist.",
+                "INVALID_SIGNATURE": "Invalid signature.",
+            };
+            const errorCode = Object.keys(knownErrors).find((c) => message.includes(c));
+            return { ok: false, error: errorCode || "HBAR_TRANSFER_FAILED", details: errorCode ? knownErrors[errorCode] : message };
+        }
+    },
+};
+exports.default = hbarTransferAction;
+//# sourceMappingURL=_sandbox_hbar_transfer.js.map

package/dist/actions/_sandbox_hbar_transfer.js.map

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

package/dist/actions/create_topic.d.ts

@@ -0,0 +1,4 @@
+import { Action } from "../types/action";
+declare const createTopicAction: Action;
+export default createTopicAction;
+//# sourceMappingURL=create_topic.d.ts.map

package/dist/actions/create_topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_topic.d.ts","sourceRoot":"","sources":["../../src/actions/create_topic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AAOvD,QAAA,MAAM,iBAAiB,EAAE,MAgJxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/actions/create_topic.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const sdk_1 = require("@hashgraph/sdk");
+const createTopicAction = {
+    name: "CREATE_TOPIC",
+    similes: [
+        "create topic",
+        "new topic",
+        "create channel",
+        "consensus topic",
+        "hcs topic",
+        "message topic",
+    ],
+    description: "Create a new topic on the Hedera Consensus Service (HCS). Topics act as message streams — any account (or only authorized ones if a submit key is set) can publish messages. The operator key is used as admin key by default.",
+    examples: [
+        [
+            {
+                input: {
+                    memo: "dappily-agent-kit event log",
+                },
+                output: {
+                    ok: true,
+                    summary: "Created topic 0.0.77777",
+                    txId: "0.0.12345@1700000000.000000000",
+                    receipt: { status: "SUCCESS" },
+                    data: {
+                        topicId: "0.0.77777",
+                        memo: "dappily-agent-kit event log",
+                        hasAdminKey: true,
+                        hasSubmitKey: false,
+                        explorerUrl: "https://hashscan.io/testnet/transaction/...",
+                    },
+                },
+                explanation: "Create an open topic (anyone can submit messages)",
+            },
+        ],
+    ],
+    schema: zod_1.z.object({
+        memo: zod_1.z
+            .string()
+            .max(100)
+            .optional()
+            .describe("Short description of the topic's purpose"),
+        requireSubmitKey: zod_1.z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("If true, only the operator (or provided key) can submit messages. Default: open to all."),
+        adminPrivateKey: zod_1.z
+            .string()
+            .optional()
+            .describe("⚠️ Admin key (only if different from operator key)"),
+        submitPrivateKey: zod_1.z
+            .string()
+            .optional()
+            .describe("⚠️ Submit key (only if different from operator key). Only used if requireSubmitKey is true."),
+    }),
+    requiresConfirmation: false,
+    simulate: async (_agent, input) => {
+        return {
+            summary: `Create HCS topic${input.memo ? `: "${input.memo}"` : ""}${input.requireSubmitKey ? " (restricted submit)" : " (open submit)"}`,
+            estimatedFeeHbar: 0.01,
+            warnings: [],
+        };
+    },
+    handler: async (agent, input) => {
+        try {
+            const adminKey = input.adminPrivateKey
+                ? sdk_1.PrivateKey.fromString(input.adminPrivateKey).publicKey
+                : agent.privateKey.publicKey;
+            const tx = new sdk_1.TopicCreateTransaction()
+                .setAdminKey(adminKey);
+            if (input.requireSubmitKey) {
+                const submitKey = input.submitPrivateKey
+                    ? sdk_1.PrivateKey.fromString(input.submitPrivateKey).publicKey
+                    : agent.privateKey.publicKey;
+                tx.setSubmitKey(submitKey);
+            }
+            if (input.memo) {
+                tx.setTopicMemo(input.memo);
+            }
+            const frozenTx = await tx.freezeWith(agent.client);
+            if (input.adminPrivateKey) {
+                await frozenTx.sign(sdk_1.PrivateKey.fromString(input.adminPrivateKey));
+            }
+            const response = await frozenTx.execute(agent.client);
+            const receipt = await response.getReceipt(agent.client);
+            if (receipt.status !== sdk_1.Status.Success) {
+                return {
+                    ok: false,
+                    error: receipt.status.toString(),
+                    details: `Topic creation failed with status: ${receipt.status.toString()}`,
+                };
+            }
+            const topicId = receipt.topicId;
+            if (!topicId) {
+                return {
+                    ok: false,
+                    error: "NO_TOPIC_ID",
+                    details: "Transaction succeeded but no topic ID was returned.",
+                };
+            }
+            const txId = response.transactionId.toString();
+            return {
+                ok: true,
+                summary: `Created topic ${topicId.toString()}`,
+                txId,
+                receipt: { status: receipt.status.toString() },
+                data: {
+                    topicId: topicId.toString(),
+                    memo: input.memo || null,
+                    hasAdminKey: true,
+                    hasSubmitKey: !!input.requireSubmitKey,
+                    explorerUrl: agent.getExplorerUrl(txId),
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const knownErrors = {
+                INVALID_SIGNATURE: "Transaction signature is invalid. Check your keys.",
+                INSUFFICIENT_PAYER_BALANCE: "Not enough HBAR to cover the transaction fee.",
+                AUTORENEW_DURATION_NOT_IN_RANGE: "The auto-renew duration is outside the allowed range.",
+            };
+            const errorCode = Object.keys(knownErrors).find((code) => message.includes(code));
+            return {
+                ok: false,
+                error: errorCode || "CREATE_TOPIC_FAILED",
+                details: errorCode ? knownErrors[errorCode] : message,
+            };
+        }
+    },
+};
+exports.default = createTopicAction;
+//# sourceMappingURL=create_topic.js.map

package/dist/actions/create_topic.js.map

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

package/dist/actions/delete_topic.d.ts

@@ -0,0 +1,4 @@
+import { Action } from "../types/action";
+declare const deleteTopicAction: Action;
+export default deleteTopicAction;
+//# sourceMappingURL=delete_topic.d.ts.map

package/dist/actions/delete_topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_topic.d.ts","sourceRoot":"","sources":["../../src/actions/delete_topic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AAOvD,QAAA,MAAM,iBAAiB,EAAE,MA0GxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}