@cordystackx/cordy_minikit

中文文档
3.1.2发布于 2026/11/06MITTypeScriptESM + CJS近 30 天下载 2271

Cordy Minikit - EVM和N-EVM钱包的开源Web3 Dev工具箱

中文使用文档
文档目录8 节
  1. 配置要点
  2. 配置地图
  3. 2025 Cordy StackX (@cordystackx) 麻省理工学院许可.
  4. 安装
  5. 3.1.1版文件
  6. 当前 API
  7. 桥 API
  8. 链接
Cordy Minikit logo

科迪·米尼基特(Cordy Minikit)

键入了Web3工具包,用于EVM和Stellar钱包访问,服务器验证的登录,平衡,转移,互换,和桥梁.

配置要点

EVM网络被宣布一次 networks. ERC-20资产按 链式 ID 下 evm;当地货币,如ETH和BOT来自 networks[].nativeCurrency 并且不应在 evm。 。 。 .

{
  "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 保持钱包,网络, 资产、 Stellar 和一个配置中的桥接设置:

flowchart LR
    config --> project["walletConnectProjectId"]
    config --> networks["networks[]<br/>EVM networks"]
    config --> evm["evm[chainId]<br/>EVM assets"]
    config --> stellarNetwork["stellarNetwork<br/>Stellar connection"]
    config --> stellar["stellar[]<br/>Stellar assets"]
    config --> routes["bridge.routes[]<br/>Bridge routes"]

原生货币属于 networks[].nativeCurrency; ERC-20合同 属于 evm["<chainId>"];桥梁方向和合同细节属于 下级 bridge.routes[]。 。 。 .

Socket Badge

Cordy Minikit wallet connection interface Cordy Minikit EVM wallet interface Cordy Minikit Stellar wallet interface

国家预防机制 • 妇女 GitHub 图像 • 妇女 文档


2025 Cordy StackX (@cordystackx) 麻省理工学院许可.

安装

npm install @cordystackx/cordy_minikit
# or
pnpm add @cordystackx/cordy_minikit

3.1.1版文件

阅读 docs/ 文件夹数字 :

当前 API

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() 清除会话并断开钱包。 见 认证指南。继续以只使用服务器的环境变量签名密钥,并永远不将其传递给客户端组件.

桥 API

cordy.bridge() 是3.1.0中支持的API。 配置路径在 assets.bridge.routes; 通过 { routeId } 当配置了多个路径时。 演示内容包括BOT链测试网QQ Sepolia和BOT链测试网BNB测试网验证器路由,外加Stellar测试网QQ Sepolia CCTP为USDC. EVM验证器交付是同步的;CCTP通过证明和目的地薄荷来完成. 见 桥道配置, (中文(简体) ), API 示例,以及 在应用程序中使用 Cordy 函数。 。 。 .

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%.

版本与发布记录

@cordystackx/cordy_minikit 共发布 74 个版本,首次发布于 2025/10/02;过去 12 个月发布了 31 个版本。

版本发布日期距今
3.1.2latest2026/11/064 天前
3.1.12026/11/046 天前
3.1.02026/11/037 天前
3.0.102026/11/028 天前
3.0.62026/10/3011 天前
3.0.52026/10/2715 天前

关于 @cordystackx/cordy_minikit 的常见问题

@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 和提交记录判断。