Formance 分类账

---

Formance 分类账是一个可编程的金融分类账，作为 Formance Stack 的一部分开发。它具有原子性、多记账交易功能，并可使用内置的 Numscript DSL 进行编程，专门用于模拟资金流动。它在需要复杂资金移动代码的应用中表现出色，例如：

• 具有复杂支付流程、支付分账的电子商务，如市场平台
• 公司发行的货币系统，例如 Twitch Bits
• 游戏内货币、库存和交易系统，例如 Fortnite V-Bucks
• 使用非标准资产的支付网关，例如学习积分
• 本地货币和补充金融

入门指南

Formance 分类账作为独立的二进制文件运行，最新版本可以从发布页面下载。您可以将二进制文件移动到任何可执行路径，如 /usr/local/bin。也可以使用 brew、apt、yum 或 docker 安装。

ledger server start

# 提交第一笔交易
echo "
send [USD/2 599] (
  source = @world
  destination = @payments:001
)

send [USD/2 599] (
  source = @payments:001
  destination = @rides:0234
)

send [USD/2 599] (
  source = @rides:0234
  destination = {
    85/100 to @drivers:042
    15/100 to @platform:fees
  }
)
" > example.num

ledger exec quickstart example.num

# 获取 drivers:042 的余额
curl -X GET http://localhost:3068/quickstart/accounts/drivers:042

# 列出交易
curl -X GET http://localhost:3068/quickstart/transactions

文档

您可以在 docs.formance.com 找到完整的 Numary 文档

社区

如果您需要帮助、想展示您的作品，或只是想闲聊分类账相关话题，欢迎加入我们的 Slack - 期待在那里见到您！

如何贡献

想为项目做贡献？请阅读 CONTRIBUTING.md 文件。

我们使用 Task 在本地轻松进行代码检查或测试。您可以通过以下命令安装：

go install github.com/go-task/task/v3/cmd/task@latest

然后运行 task 来执行代码检查和测试。您可以在 Taskfile 中找到其他任务。

贡献者 ✨

感谢这些优秀的人（表情符号含义）：

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center"><a href="https://github.com/Azorlogh"><img src="https://avatars.githubusercontent.com/u/17968319?v=4?s=100" width="100px;" alt=""/><br />_{<b>Alix Bott</b>}</a><br /><a href="https://github.com/formancehq/ledger/commits?author=Azorlogh" title="Code">💻</a></td> <td align="center"><a href="https://www.flemzord.fr/"><img src="https://avatars.githubusercontent.com/u/1952914?v=4?s=100" width="100px;" alt=""/><br />_{<b>Maxence Maireaux</b>}</a><br /><a href="#infra-flemzord" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#platform-flemzord" title="Packaging/porting to new platform">📦</a> <a href="https://github.com/formancehq/ledger/commits?author=flemzord" title="Code">💻</a></td> <td align="center"><a href="https://github.com/henry-jackson"><img src="https://avatars.githubusercontent.com/u/34102861?v=4?s=100" width="100px;" alt=""/><br />_{<b>Henry Jackson</b>}</a><br /><a href="https://github.com/formancehq/ledger/commits?author=henry-jackson" title="Code">💻</a></td> <td align="center"><a href="https://matias.insaurral.de/"><img src="https://avatars.githubusercontent.com/u/20110?v=4?s=100" width="100px;" alt=""/><br />_{<b>Matias Insaurralde</b>}</a><br /><a href="https://github.com/formancehq/ledger/commits?author=matiasinsaurralde" title="Code">💻</a> <a href="https://github.com/formancehq/ledger/pulls?q=is%3Apr+reviewed-by%3Amatiasinsaurralde" title="Reviewed Pull Requests">👀</a></td> <td align="center"><a href="https://github.com/S0c5"><img src="https://avatars.githubusercontent.com/u/5241972?v=4?s=100" width="100px;" alt=""/><br />_{<b>David barinas</b>}</a><br /><a href="https://github.com/formancehq/ledger/commits?author=S0c5" title="Code">💻</a></td> <td align="center"><a href="https://github.com/djimnz"><img src="https://avatars.githubusercontent.com/u/949997?v=4?s=100" width="100px;" alt=""/><br />_{<b>David Jimenez</b>}</a><br /><a href="https://github.com/formancehq/ledger/commits?author=djimnz" title="Code">💻</a></td> <td align="center"><a href="http://32b6.com/"><img src="https://avatars.githubusercontent.com/u/1770991?v=4?s=100" width="100px;" alt=""/><br />_{<b>Clément Salaün</b>}</a><br /><a href="#ideas-altitude" title="Ideas, Planning, & Feedback">🤔</a></td> </tr> <tr> <td align="center"><a href="https://karmanyaah.malhotra.cc/"><img src="https://avatars.githubusercontent.com/u/32671690?v=4?s=100" width="100px;" alt=""/><br />_{<b>Karmanyaah Malhotra</b>}</a><br /><a href="#userTesting-karmanyaahm" title="User Testing">📓</a></td> <td align="center"><a href="https://www.linkedin.com/in/antoinegelloz/"><img src="https://avatars.githubusercontent.com/u/42968436?v=4?s=100" width="100px;" alt=""/><br />_{<b>Antoine Gelloz</b>}</a><br /><a href="https://github.com/formancehq/ledger/commits?author=antoinegelloz" title="Code">💻</a></td> <td align="center"><a href="https://github.com/jdupas22"><img src="https://avatars.githubusercontent.com/u/106673437?v=4?s=100" width="100px;" alt=""/><br />_{<b>jdupas22</b>}</a><br /><a href="https://github.com/formancehq/ledger/commits?author=jdupas22" title="Code">💻</a></td> <td align="center"><a href="https://edwardpoot.com"><img src="https://avatars.githubusercontent.com/u/1686739?v=4?s=100" width="100px;" alt=""/><br />_{<b>Edward Poot</b>}</a><br /><a href="https://github.com/formancehq/ledger/commits?author=edwardmp" title="Code">💻</a></td> <td align="center"><a href="https://github.com/nicoabie"><img src="https://avatars.githubusercontent.com/u/2797992?v=4?s=100" width="100px;" alt=""/><br />_{<b>Nico Gallinal</b>}</a><br /><a href="https://github.com/formancehq/ledger/issues?q=author%3Anicoabie" title="Bug reports">🐛</a></td> <td align="center"><a href="https://github.com/gfyrag"><img src="https://avatars.githubusercontent.com/u/9094799?v=4?s=100" width="100px;" alt=""/><br />_{<b>Ragot Geoffrey</b>}</a><br /><a href="https://github.com/formancehq/ledger/commits?author=gfyrag" title="Code">💻</a></td> </tr> </tbody> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->

本项目遵循 all-contributors 规范。欢迎任何形式的贡献！