Stellar-Clear/clearledger-contracts

选用指南

AI 根据 README 整理 · 2026/10/14 15:35:55

使用方式

通过 Rust 工作区构建和部署 Soroban 合约，使用 Stellar CLI 和脚本进行测试网部署。

查看 README 依据

[Pool](https://stellar.expert/explorer/testnet/contract/CDBJEGCV3IENZJKCK3LYYOSA7B5NZSPELBE7FPFHUKLG74LRJTCQIZ45) ## Build and contribute The workspace pins Rust 1.85.0 and the `wasm32v1-none` target in `rust-toolchain.toml`. Install the toolchain and Stellar CLI, then run: ```bash rustup toolchain install 1.85.0 rustup target add wasm32v1-none --toolchain 1.85.0 cargo fmt --all --check cargo clippy --all-targets --all-features -- -D warnings cargo test --workspace cargo build --workspace --release --target wasm32v1-none ```

For a fresh testnet deployment, configure `.env` using `.env.example`, fund a testnet deployer, then run: ```bash bash scripts/setup-testnet.sh bash scripts/deploy.sh ``` The deployment script supports resumable deployments and updates the address table above. See [DEPLOYMENT.md](DEPLOYMENT.md) for configuration, wiring, verification, and rollback details. The default deployment targets the supported USDC workflow; XLM deployment is experimental and opt-in.

部署要求

需要 Rust 1.85.0 和 wasm32v1-none 目标，以及 Stellar CLI。部署测试网需配置 .env 并资助测试网部署账户。

查看 README 依据

[Pool](https://stellar.expert/explorer/testnet/contract/CDBJEGCV3IENZJKCK3LYYOSA7B5NZSPELBE7FPFHUKLG74LRJTCQIZ45) ## Build and contribute The workspace pins Rust 1.85.0 and the `wasm32v1-none` target in `rust-toolchain.toml`. Install the toolchain and Stellar CLI, then run: ```bash rustup toolchain install 1.85.0 rustup target add wasm32v1-none --toolchain 1.85.0 cargo fmt --all --check cargo clippy --all-targets --all-features -- -D warnings cargo test --workspace cargo build --workspace --release --target wasm32v1-none ```

For a fresh testnet deployment, configure `.env` using `.env.example`, fund a testnet deployer, then run: ```bash bash scripts/setup-testnet.sh bash scripts/deploy.sh ``` The deployment script supports resumable deployments and updates the address table above. See [DEPLOYMENT.md](DEPLOYMENT.md) for configuration, wiring, verification, and rollback details. The default deployment targets the supported USDC workflow; XLM deployment is experimental and opt-in.

已知限制

合约部署在测试网且未经正式审计，存在已知限制，包括发行人支付路径未接入发票融资，且不验证商业文件合法性。

查看 README 依据

The system coordinates on-chain state and token transfers. It does not validate the underlying commercial documents or establish that an invoice is legitimate. ### Invoice lifecycle ```text Created → Listed → Funded → Active → Confirmed → Repaid └──────────────────→ Defaulted ``` Participant verification and invoice status are checked on-chain at relevant transitions. The optional Underwrite agent registry integration is a separate dependency and must be configured for attestation-gated listing. ## Testnet deployments

These contracts are deployed on Stellar Testnet and have not been formally audited. The current implementation has known functional and trust-model limitations, including an issuer payout path that is not yet wired into invoice funding. Review [known limitations](docs/LIMITATIONS.md) and [SECURITY.md](SECURITY.md) before integrating. Do not use real funds or treat testnet assets as redeemable value.