nirium 0.19.1 → 0.19.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,9 +4,9 @@ Verifiable receipts, agentic payments and treasury execution for **Nirium Protoc
|
|
|
4
4
|
|
|
5
5
|
- **Audit Trail:** anchor a SHA-256 of any event to IPFS and get back a CID that anyone can re-check, optionally signed with your agent's own Stellar key so it also proves *who* declared it. See [Audit Trail](#audit-trail).
|
|
6
6
|
- **x402 payments, both directions:** pay for other APIs with `initX402()` and charge for your own with `x402Serve()`. An MPP Charge client is included, experimental.
|
|
7
|
-
- **Treasury:** a Nirium agent can
|
|
7
|
+
- **Treasury:** a Nirium agent can move a vault you own between idle cash and its strategy (USDC, or tokenized CETES issued by Etherfuse). Nothing is swapped. It runs on its own on testnet. On mainnet, deploying, depositing, proposals and autonomous execution are invite-only, and withdrawing is always open.
|
|
8
8
|
|
|
9
|
-
**Status:** x402 and Audit Trail run on Stellar mainnet; MPP Charge is testnet
|
|
9
|
+
**Status:** x402 and Audit Trail run on Stellar mainnet; MPP Charge is verified on testnet and untested on mainnet; Treasury on mainnet is invite-only (withdrawing stays open). Every claim, with its network, date and transaction hash: [EVIDENCE.md](https://github.com/nirium-protocol/nirium/blob/main/EVIDENCE.md).
|
|
10
10
|
|
|
11
11
|
## Install
|
|
12
12
|
|
|
@@ -450,11 +450,11 @@ Mainnet is invite-only during early access and additionally requires `clientInfo
|
|
|
450
450
|
|
|
451
451
|
## Treasury Rebalance
|
|
452
452
|
|
|
453
|
-
Two ways to rebalance a DeFindex vault between idle cash and an invested strategy. Neither is a swap
|
|
453
|
+
Two ways to rebalance a DeFindex vault between idle cash and an invested strategy. Neither is a swap. The contract's `rebalance()` accepts four instructions (`Unwind`, `Invest`, `SwapExactIn`, `SwapExactOut`); these methods only send `Unwind` and `Invest`. None of the four accepts a destination address, so withdrawing anywhere but back into the vault itself is not expressible.
|
|
454
454
|
|
|
455
|
-
### Propose: you review and sign,
|
|
455
|
+
### Propose: you review and sign (open on testnet, invite-only on mainnet)
|
|
456
456
|
|
|
457
|
-
The agent decides what it would do, using the same decision logic as the autonomous signer below, but it never signs.
|
|
457
|
+
The agent decides what it would do, using the same decision logic as the autonomous signer below, but it never signs. Works for any vault where you're already the on-chain rebalance manager. Open to any key on testnet. On mainnet it needs an invited (institutional) key, like every Treasury call that builds a transaction except withdraw; a free key gets a 403.
|
|
458
458
|
|
|
459
459
|
```typescript
|
|
460
460
|
const proposal = await agent.proposeTreasuryRebalance({
|
|
@@ -472,7 +472,7 @@ if (proposal.instructions.length) {
|
|
|
472
472
|
}
|
|
473
473
|
```
|
|
474
474
|
|
|
475
|
-
### Autonomous: Nirium signs, invite-only
|
|
475
|
+
### Autonomous: Nirium signs, invite-only until a written legal opinion
|
|
476
476
|
|
|
477
477
|
`executeTreasuryRebalance()` has Nirium sign and submit with its own RebalanceManager key - full autonomy, no per-cycle approval. **This is invite-only while a specific legal question stays open**: whether executing on a client's behalf without taking custody still counts as regulated facilitation under Mexican law. It only runs against vaults explicitly allowlisted server-side; calling it against any other vault returns 403, and Nirium's mainnet infrastructure returns 501 for it entirely, since that box holds no signing key by design. Ask if you want autonomous execution today - otherwise, `proposeTreasuryRebalance()` above gives you the same decision-making with you as the one who signs.
|
|
478
478
|
|