# @cordystackx/cordy\_minikit 中文文档 规范地址：https://npmcn.com/package/%40cordystackx/cordy_minikit/ 版本：3\.1\.2 npm 元数据更新时间：2026-11-06T10:08:16.258Z 中文译文更新时间：2026-11-11T01:24:22.716Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40cordystackx/cordy_minikit 原文对照：https://npmcn.com/package/%40cordystackx/cordy_minikit/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.6 MB，111 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：13 个 - peer 依赖：next \>=13，react \>=18，wagmi \>=3，react-dom \>=18 - 首次发布：2025-10-01T19:29:07.592Z - 最新版本发布：2026-11-06T10:08:16.068Z - 近 30 天下载量：2271（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：74（近 12 个月 31 个） ## 中文简介 Cordy Minikit - EVM和N-EVM钱包的开源Web3 Dev工具箱 ## 安装 ```sh npm install @cordystackx/cordy_minikit ``` 也可以使用：`pnpm add @cordystackx/cordy_minikit`、`yarn add @cordystackx/cordy_minikit`、`bun add @cordystackx/cordy_minikit` ## README ![Cordy Minikit logo](https://raw.githubusercontent.com/cordyStackX/cordy_minikit_official/21cb17b5569b79b29545da80da33d82625e26c7b/assets/cordy-logo.svg) # 科迪·米尼基特(Cordy Minikit) 键入了Web3工具包,用于EVM和Stellar钱包访问,服务器验证的登录,平衡,转移,互换,和桥梁. ## 配置要点 EVM网络被宣布一次 `networks`. ERC-20资产按 链式 ID 下 `evm`;当地货币,如ETH和BOT来自 `networks[].nativeCurrency` 并且不应在 `evm`。 。 。 . ```json { "networks": [ { "chainId": 11155111, "name": "Ethereum Sepolia", "nativeCurrency": { "name": "Sepolia Ether", "symbol": "ETH", "decimals": 18 }, "rpcUrl": "https://rpc.example" } ], "evm": { "11155111": [ { "symbol": "USDC", "contractAddress": "0xToken", "decimals": 6 } ] } } ``` 钱包可能在另一个EVM网络上连接,但Cordy拒绝平衡, ,并交换操作,直到该链被配置。 桥口钱包 连接可以准备配置的路由网络, 并在 支持的钱包 `wallet_addEthereumChain` 财务报告和审定财务报表 `wallet_watchAsset`。 。 。 . ## 配置地图 演示会 [`assets.json`](https://npmcn.com/package/%40cordystackx/cordy_minikit/demo/src/config/assets.json) 保持钱包,网络, 资产、 Stellar 和一个配置中的桥接设置: ```mermaid flowchart LR config --> project["walletConnectProjectId"] config --> networks["networks[]
EVM networks"] config --> evm["evm[chainId]
EVM assets"] config --> stellarNetwork["stellarNetwork
Stellar connection"] config --> stellar["stellar[]
Stellar assets"] config --> routes["bridge.routes[]
Bridge routes"] ``` 原生货币属于 `networks[].nativeCurrency`; ERC-20合同 属于 `evm[""]`;桥梁方向和合同细节属于 下级 `bridge.routes[]`。 。 。 . [![Socket Badge](https://badge.socket.dev/npm/package/@cordystackx/cordy_minikit/3.1.1)](https://badge.socket.dev/npm/package/@cordystackx/cordy_minikit/3.1.1) ![Cordy Minikit wallet connection interface](https://raw.githubusercontent.com/cordyStackX/cordy_minikit_official/refs/heads/main/assets/demo1.png) ![Cordy Minikit EVM wallet interface](https://raw.githubusercontent.com/cordyStackX/cordy_minikit_official/refs/heads/main/assets/demo2.png) ![Cordy Minikit Stellar wallet interface](https://raw.githubusercontent.com/cordyStackX/cordy_minikit_official/refs/heads/main/assets/demo3.png) [国家预防机制](https://www.npmjs.com/package/@cordystackx/cordy_minikit) • 妇女 [GitHub 图像](https://github.com/cordyStackX/cordy_minikit_official) • 妇女 [文档](https://github.com/cordyStackX/cordy_minikit_official/blob/main/docs/README.md) * * * ## 2025 Cordy StackX (@cordystackx) 麻省理工学院许可. ## 安装 ```bash npm install @cordystackx/cordy_minikit # or pnpm add @cordystackx/cordy_minikit ``` ## 3.1.1版文件 阅读 [`docs/` 文件夹](https://npmcn.com/package/%40cordystackx/cordy_minikit/docs/README.md)数字 : - [文件索引](https://github.com/cordyStackX/cordy_minikit_official/blob/main/docs/README.md) - [环境配置](https://github.com/cordyStackX/cordy_minikit_official/blob/main/docs/environment.md) - [3.1.1 API参考](https://github.com/cordyStackX/cordy_minikit_official/blob/main/docs/api.md) - [3.0.0 移徙指南](https://github.com/cordyStackX/cordy_minikit_official/blob/main/docs/migration-3.0.0.md) - [提供者和钱包 UI 设置](https://github.com/cordyStackX/cordy_minikit_official/blob/main/docs/setup.md) - [在应用程序中使用 Cordy 函数](https://github.com/cordyStackX/cordy_minikit_official/blob/main/docs/recipes.md) ## 当前 API ```ts import { cordy } from "@cordystackx/cordy_minikit"; const wallet = await cordy.cons_verify(); const balance = await cordy.balance(); const transfer = await cordy.transfer("1", recipient); await cordy.cons_disconnect(); ``` 目前的3.1.1 API是: - `cordy.configure({ assets })` - `cordy.cons_verify()` - `cordy.cons_disconnect()` - `useConsSession()` - `createCordyServer()` 从 `@cordystackx/cordy_minikit/server` - `cordy.transfer()` - `cordy.balance()` - `cordy.swap(amount, from, to, tolerancePercent?, options?)` - `cordy.bridge(amount, from, to, recipient, options?)` 与 `cons_session={true}`, (中文(简体) ), `ConnectWalletBT` 请求钱包签名,通过您的服务器验证 SIWE (EVM) 或 SEP- 10 (Stellar) , 只有在验证成功后才能导航 。 挂载 SDK 服务器处理器并配置它 `createCordyServer()`; SDK 从未读取环境变量 . `cordy.cons_verify()` 财务报告和审定财务报表 `useConsSession()` 读取生成的服务器会话,同时 `cordy.cons_disconnect()` 清除会话并断开钱包。 见 [认证指南](https://npmcn.com/package/%40cordystackx/cordy_minikit/docs/api.md#server-authentication)。继续以只使用服务器的环境变量签名密钥,并永远不将其传递给客户端组件. ## 桥 API `cordy.bridge()` 是3.1.0中支持的API。 配置路径在 `assets.bridge.routes`; 通过 `{ routeId }` 当配置了多个路径时。 演示内容包括BOT链测试网QQ Sepolia和BOT链测试网BNB测试网验证器路由,外加Stellar测试网QQ Sepolia CCTP为USDC. EVM验证器交付是同步的;CCTP通过证明和目的地薄荷来完成. 见 [桥道配置](https://npmcn.com/package/%40cordystackx/cordy_minikit/docs/environment.md#bridge-routes), (中文(简体) ), [API 示例](https://npmcn.com/package/%40cordystackx/cordy_minikit/docs/api.md#cordybridgeamount-from-to-recipient-options),以及 [在应用程序中使用 Cordy 函数](https://npmcn.com/package/%40cordystackx/cordy_minikit/docs/recipes.md)。 。 。 . `cordy.swap(amount, from, to, tolerancePercent?, options?)` 用于配置的 EVM 和 Stellar 资产。 EVM 网络可以配置一个 V2 `swapRouterAddress`编号, V3 `swapV3` 路由器和引文V2,或两者兼有. 默认 `auto` 模式比较所配置的引用; 使用 `{ version: "v2" }` 或者说 `{ version: "v3" }` 明确选择。 过 `feeTiers: [500, 3000]` 为一次呼叫而覆盖已配置的 V3 级的选项 `version: "auto"`,V2仍然仅与所选V3级进行比较。 等级 `500`, (中文(简体) ), `3000`,以及 `10000` 对应于0.05%、0.30%和1.00%的集合费。 每个网络都需要兼容的部署、收费等级、象征性地址和可用的流动资金。 本地 EVM 互换也需要 `wrappedNativeTokenAddress`. Stellar switchs 使用 Horizon 严格发送路径支付,并需要活期流动性路径. 容忍论是一个百分比: `1` 表示1%的容忍度,而忽略默认为1%. ## 链接 - [国家防范机制一揽子计划](https://www.npmjs.com/package/@cordystackx/cordy_minikit) - [GitHub 仓库](https://github.com/cordyStackX/cordy_minikit_official) - [更改日志](https://github.com/cordyStackX/cordy_minikit_official/blob/main/CHANGELOG.md) - [贡献指南](https://github.com/cordyStackX/cordy_minikit_official/blob/main/CONTRIBUTING.md) - [安全政策](https://github.com/cordyStackX/cordy_minikit_official/blob/main/SECURITY.md) ## 常见问题 ### @cordystackx/cordy\_minikit 是什么？ Cordy Minikit - EVM和N-EVM钱包的开源Web3 Dev工具箱 ### 如何安装 @cordystackx/cordy\_minikit？ 在项目目录运行 npm install @cordystackx/cordy\_minikit，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：next（\>=13）、react（\>=18）、wagmi（\>=3）、react-dom（\>=18）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @cordystackx/cordy\_minikit 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @cordystackx/cordy\_minikit 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @cordystackx/cordy\_minikit 可以商用吗？ @cordystackx/cordy\_minikit 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @cordystackx/cordy\_minikit 的下载量有多少？ 根据 npm 官方下载统计，@cordystackx/cordy\_minikit 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,271 次，日均约 76 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @cordystackx/cordy\_minikit 还在维护吗？ 最新版本 3\.1\.2 发布于 2026/11/06（4 天前）；至今共发布 74 个版本，其中过去 12 个月发布了 31 个；首次发布于 2025/10/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。