Boxkit-Labs/stellar-address-kit
GitHub: Boxkit-Labs/stellar-address-kit
一个用于统一处理Stellar网络多种地址类型并提取路由信息的多语言库，解决跨语言集成中的路由不一致问题。
Stars: 11 | Forks: 63
**Stellar Address Kit** 是一个专业、多语言的库，旨在解决 Stellar 网络中存款路由的复杂性。它提供了一种统一、符合规范的方式，在 TypeScript、Go 和 Dart 中处理 G-地址（经典）、M-地址（多路复用）和 C-地址（合约）。
## 文档
欲获取完整的技术规范、架构深度解析和 API 参考，请访问我们的[在线文档](https://stellaraddresskit.mintlify.app/docs/introduction)。
- **[快速入门](https://stellaraddresskit.mintlify.app/docs/quickstart)**：60 秒内即可开始运行。
- **[路由逻辑](https://stellaraddresskit.mintlify.app/docs/concepts/routing-logic)**：所有路由场景的完整参考。
- **[常见错误](https://stellaraddresskit.mintlify.app/docs/common-mistakes)**：避免 6 个最常见的集成陷阱。
- **[语言指南](https://stellaraddresskit.mintlify.app/docs/guides/go-deposit-routing)**：针对 Go、TypeScript 和 Flutter 的专项指南。
## 包
| 平台 | 包名 | 安装命令 |
| ------------------ | --------------------- | -------------------------------------------------------------------- |
| **TypeScript** | `stellar-address-kit` | `npm install stellar-address-kit` |
| **Go** | `core-go` | `go get github.com/Boxkit-Labs/stellar-address-kit/packages/core-go` |
| **Dart / Flutter** | `stellar_address_kit` | `dart pub add stellar_address_kit` |
## 快速示例
从任何地址类型（G、M 或 C）中提取规范的路由信息，并具备零抛出异常的安全性。
```
import { extractRouting } from "stellar-address-kit";
// Handles M-addresses, G-addresses with memos, and C-addresses
const result = extractRouting({
address:
"MA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLT7AV7Y6S33Z6S3CHBAAAAAAAAAAAAABQD",
});
console.log(result.address); // "GA7Q..."
console.log(result.routingId); // "123"
```
## 核心功能
- **规范优先设计**：通过共享测试向量套件，确保在三种语言中行为完全一致。
- **精度安全**：内置保护机制，防止在 JavaScript 和 Flutter Web 中出现 64 位整数精度丢失。
- **警告系统**：使用可辨识联合类型（TS）或结构化对象（Go/Dart）来捕获数值 `MEMO_TEXT` 等边缘情况。
- **零依赖**：核心逻辑轻量级，除标准库功能外，无任何外部依赖。
## 维护者
- **codeZeus** - [GitHub](https://github.com/codeZe-us)
## 许可证
本项目基于 MIT 许可证授权 - 详情请参阅 [LICENSE](LICENSE) 文件。
标签：Dart语言, Go语言, MIT许可, Stellar网络, TypeScript, 交易所, 加密货币, 区块链, 地址处理, 多语言库, 存款路由, 安全插件, 开源, 技术文档, 支付系统, 日志审计, 程序破解, 统一接口, 规范兼容, 跨平台开发, 路由策略, 钱包