@chironbuilder/ootle-sdk 0.1.12 → 0.1.13
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 +2 -1
- package/dist/wallet.d.ts +9 -1
- package/dist/wallet.d.ts.map +1 -1
- package/dist/wallet.js +124 -45
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -73,7 +73,8 @@ import { assembleBurnClaimProof, parseConsoleWalletBurnProof } from "@chironbuil
|
|
|
73
73
|
|
|
74
74
|
const proof = assembleBurnClaimProof(l1BurnParts, kernelMerkleProof);
|
|
75
75
|
// or: const proof = parseConsoleWalletBurnProof(fileText);
|
|
76
|
-
|
|
76
|
+
// The fee is measured with a dry run; a stealth-revealed fee is never refunded, so it is not padded.
|
|
77
|
+
const { claimedAmount, fee } = await account.claimBurn(proof);
|
|
77
78
|
```
|
|
78
79
|
|
|
79
80
|
The claimed funds arrive as a stealth output owned by this account and are recorded in its private
|
package/dist/wallet.d.ts
CHANGED
|
@@ -715,13 +715,18 @@ export declare class OotleAccount implements WalletAccountApi {
|
|
|
715
715
|
/**
|
|
716
716
|
* Claims a Layer 1 (minotari) burn addressed to this account, minting the burned value on
|
|
717
717
|
* Ootle as a stealth output owned by this account (recorded locally, so it shows in the private
|
|
718
|
-
* balance).
|
|
718
|
+
* balance). The fee is revealed from the claimed value; the rest is claimed.
|
|
719
719
|
*
|
|
720
720
|
* The burn UTXO is minted and spent within the fee instructions, and the transaction is sealed
|
|
721
721
|
* with the stealth claim secret `s = H(p·R) + p` rather than the account key: the L1 ownership
|
|
722
722
|
* proof commits the burn to `s·G`, so `s` is the only key that satisfies its spend condition.
|
|
723
723
|
* Nothing here touches the account component, so the account need not exist on-chain yet.
|
|
724
724
|
*
|
|
725
|
+
* A fee paid purely by stealth reveal is not refundable -- whatever is revealed is kept -- so
|
|
726
|
+
* `maxFee` should sit on the required fee rather than above it. Left unset, it is measured: a
|
|
727
|
+
* dry run meters the claim, and the claim is submitted with that cost plus the engine's own
|
|
728
|
+
* estimate allowance (`FeeReceipt::required_fees`).
|
|
729
|
+
*
|
|
725
730
|
* Validators only accept a burn once its L1 block is well confirmed; claiming earlier is
|
|
726
731
|
* rejected and can simply be retried later.
|
|
727
732
|
*/
|
|
@@ -729,7 +734,10 @@ export declare class OotleAccount implements WalletAccountApi {
|
|
|
729
734
|
transactionId: string;
|
|
730
735
|
claimedAmount: bigint;
|
|
731
736
|
commitment: string;
|
|
737
|
+
fee: bigint;
|
|
732
738
|
}>;
|
|
739
|
+
/** Dry-runs a sealed claim and returns the fee it needs: what it was charged plus the allowance. */
|
|
740
|
+
private estimateClaimFee;
|
|
733
741
|
/**
|
|
734
742
|
* This account's unspent stealth outputs, newest first, optionally filtered to one resource.
|
|
735
743
|
*
|
package/dist/wallet.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,OAAO,EA4BR,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EACV,aAAa,EACb,mCAAmC,EACnC,WAAW,EAIX,mBAAmB,EACnB,aAAa,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAcxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAI9D,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAcrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD;;;yFAGyF;AACzF,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC;AAahG,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf;;;wCAGoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;kCAE8B;IAC9B,2BAA2B,EAAE,MAAM,CAAC;IACpC;yEACqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB;sEACkE;IAClE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;oDACgD;IAChD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;mGAE+F;IAC/F,mBAAmB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACtC;AAED;;;4CAG4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB;iCAC6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf;gFAC4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAmCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASpF;AAoCD;;;GAGG;AACH,qBAAa,YAAa,YAAW,gBAAgB;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAgC;IAKhD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,OAAO;IAOP,+FAA+F;IAC/F,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,YAAY;IAOrF,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAqB7C;;;;;OAKG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC;IAIzC;;;;;;;;OAQG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,OAAO,EA4BR,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EACV,aAAa,EACb,mCAAmC,EACnC,WAAW,EAIX,mBAAmB,EACnB,aAAa,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAcxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAI9D,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAcrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD;;;yFAGyF;AACzF,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC;AAahG,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf;;;wCAGoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;kCAE8B;IAC9B,2BAA2B,EAAE,MAAM,CAAC;IACpC;yEACqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB;sEACkE;IAClE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;oDACgD;IAChD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;mGAE+F;IAC/F,mBAAmB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACtC;AAED;;;4CAG4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB;iCAC6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf;gFAC4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAmCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASpF;AAoCD;;;GAGG;AACH,qBAAa,YAAa,YAAW,gBAAgB;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAgC;IAKhD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,OAAO;IAOP,+FAA+F;IAC/F,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,YAAY;IAOrF,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAqB7C;;;;;OAKG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC;IAIzC;;;;;;;;OAQG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAkJ5C;;;;;;;;;;;;;;;;OAgBG;IACG,OAAO,CACX,YAAY,EAAE,WAAW,EAAE,EAC3B,IAAI,GAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;QAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB;;;;;;;WAOG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;KACd;wBA8IqB,aAAa;gBAAU,aAAa;;wBA4DE,aAAa;;wBA62E4B,MAAM;;IA/7ElH;;;;;;;;;;;;;;;;;OAiBG;YACW,YAAY;IAgD1B;;;;;;;;;;;OAWG;YACW,UAAU;IAoCxB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAQ,EAAE,OAAO,GAAE,OAAiC;wBApH3G,aAAa;gBAAU,aAAa;;wBA4DE,aAAa;;wBA62E4B,MAAM;;IAnxElH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,EAAE,OAAO,GAAE,OAAiC;wBApLjG,aAAa;gBAAU,aAAa;;wBA4DE,aAAa;;wBA62E4B,MAAM;;IAxsElH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,eAAe,CAAC,MAAM,SAAQ,EAAE,OAAO,SAAK,EAAE,YAAY,SAAM;IA0EtE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,MAAM,CACV,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,SAAS,EACf,IAAI,CAAC,EAAE,MAAM,EACb,mBAAmB,SAAK,EACxB,OAAO,GAAE,OAAiC,GACzC,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;IAkD1G;;;;;;;;;;;;;;;OAeG;IACG,kBAAkB,CACtB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA4BzE;;;;;;;;;;;;;OAaG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAOxH;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,QAAQ,CACZ,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,MAAM,EACzB,MAAM,SAAU,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,OAAiC,GACzC,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAqErC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,yBAAyB,CAC7B,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,EAAE,WAAW,EAAE,EACnC,iBAAiB,GAAE,MAAM,EAAO,EAChC,MAAM,SAAU,EAChB,OAAO,GAAE,OAAiC,GACzC,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAsCrC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,6BAA6B,CACjC,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,WAAW,EAAE,EACnC,iBAAiB,GAAE,MAAM,EAAO,EAChC,MAAM,SAAU,EAChB,OAAO,GAAE,OAAiC,GACzC,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAmGrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACH;;;;;;;;;;;;;;;;;;OAkBG;YACW,2BAA2B;IAgFzC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;;;OAOG;YACW,kBAAkB;IAOhC;;;;;OAKG;YACW,qBAAqB;IAKnC;;;;OAIG;YACW,iBAAiB;IAmD/B;;;;;;;;;;;;;;;;;OAiBG;YACW,6BAA6B;IAkC3C;;;;;;;;;;;;OAYG;YACW,iBAAiB;IAsBzB,iCAAiC,CACrC,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,oBAAoB,EAAE,WAAW,EAAE,EACnC,kBAAkB,EAAE,MAAM,EAC1B,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,EACd,iBAAiB,GAAE,MAAM,EAAO,GAC/B,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;IAsFlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,QAAQ,CACZ,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,qBAAqB,EAAE,MAAM,EAC7B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,SAAS,EACf,OAAO,GAAE,OAAiC,GACzC,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAwCtG;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,SAAS,CACb,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,SAAS,EACf,OAAO,GAAE,OAAiC,GACzC,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAmDrC;;;;;;;;;;;;;;;;;OAiBG;IACG,UAAU,CACd,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,SAAS,EACf,OAAO,GAAE,OAAiC,GACzC,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAuCrC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,aAAa,CACjB,eAAe,EAAE,MAAM,EACvB,sBAAsB,EAAE,MAAM,EAC9B,MAAM,EAAE,MAAM,EACd,MAAM,SAAU,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,mBAAmB,SAAK,EACxB,OAAO,GAAE,OAAiC,GACzC,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;IA+E5H;;;;;;;;;OASG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBrH;;;;;;;;;;;;;;;;;OAiBG;IACG,SAAS,CACb,QAAQ,EAAE,sBAAsB,EAChC,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,SAAgC,GACnC,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAkG7F,oGAAoG;YACtF,gBAAgB;IA4B9B;;;;;;;;OAQG;IACG,0BAA0B,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAI3F;;;;;;;;;;;;;;;OAeG;IACG,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAiBrD;;;;;;;;;;;;;;OAcG;IACG,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IA4D3H;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,oBAAoB,CACxB,eAAe,EAAE,MAAM,EACvB,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAC7F,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAoFnC;AAED;;;;;;;;;GASG;AACH;;;;;;;;;;;;;GAaG;AAIH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb;6DACyD;IACzD,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB,EAAE,MAAM,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CA2BT;AAuED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3C,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAC5C,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GACzC,YAAY,EAAE,CAiBhB;AAoBD;;;;;;;;;;;GAWG;AACH;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAI9H;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,EAAE,GAC9B;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CASpE;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,oBAAoB,EAAE,EAC/B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB;IAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,oBAAoB,EAAE,CAAA;CAAE,CAiBzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,MAAM,GACxB;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmB9C;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAM,EAAO,GACrB,oBAAoB,CAetB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GACb;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAOjD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCpF;AA+HD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9E;AAED;;0GAE0G;AAC1G,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,eAAe,EACzB,aAAa,EAAE,MAAM,EACrB,SAAS,SAAS,GACjB,OAAO,CAAC,mCAAmC,CAAC,CAwB9C;AAmBD,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,mBAAmB,EAAE,EACnC,OAAO,SAAI,EACX,YAAY,SAAM,GACjB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAUhC;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQpG;AAmBD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM5E;AAOD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGvG"}
|
package/dist/wallet.js
CHANGED
|
@@ -190,7 +190,10 @@ export class OotleAccount {
|
|
|
190
190
|
// actually wrong in the latter case.
|
|
191
191
|
if (e instanceof Error && e.message.startsWith("Timed out"))
|
|
192
192
|
throw e;
|
|
193
|
-
|
|
193
|
+
// Account not yet on-chain (never funded publicly). It can still hold stealth outputs -- a
|
|
194
|
+
// claimed L1 burn or a redeemed private payment needs no account component -- so the
|
|
195
|
+
// private ledger below is still read rather than returning empty here.
|
|
196
|
+
vaultIds = [];
|
|
194
197
|
}
|
|
195
198
|
// Fold in this account's own known-good stealth outputs (from shield()/unshield(), or from
|
|
196
199
|
// redeeming someone else's shared commitment via the "Advanced" unshield flow) up front, not
|
|
@@ -1803,18 +1806,23 @@ export class OotleAccount {
|
|
|
1803
1806
|
/**
|
|
1804
1807
|
* Claims a Layer 1 (minotari) burn addressed to this account, minting the burned value on
|
|
1805
1808
|
* Ootle as a stealth output owned by this account (recorded locally, so it shows in the private
|
|
1806
|
-
* balance).
|
|
1809
|
+
* balance). The fee is revealed from the claimed value; the rest is claimed.
|
|
1807
1810
|
*
|
|
1808
1811
|
* The burn UTXO is minted and spent within the fee instructions, and the transaction is sealed
|
|
1809
1812
|
* with the stealth claim secret `s = H(p·R) + p` rather than the account key: the L1 ownership
|
|
1810
1813
|
* proof commits the burn to `s·G`, so `s` is the only key that satisfies its spend condition.
|
|
1811
1814
|
* Nothing here touches the account component, so the account need not exist on-chain yet.
|
|
1812
1815
|
*
|
|
1816
|
+
* A fee paid purely by stealth reveal is not refundable -- whatever is revealed is kept -- so
|
|
1817
|
+
* `maxFee` should sit on the required fee rather than above it. Left unset, it is measured: a
|
|
1818
|
+
* dry run meters the claim, and the claim is submitted with that cost plus the engine's own
|
|
1819
|
+
* estimate allowance (`FeeReceipt::required_fees`).
|
|
1820
|
+
*
|
|
1813
1821
|
* Validators only accept a burn once its L1 block is well confirmed; claiming earlier is
|
|
1814
1822
|
* rejected and can simply be retried later.
|
|
1815
1823
|
*/
|
|
1816
|
-
async claimBurn(contents, maxFee
|
|
1817
|
-
if (maxFee <= 0n)
|
|
1824
|
+
async claimBurn(contents, maxFee, memo = "Burnt funds claimed from L1") {
|
|
1825
|
+
if (maxFee !== undefined && maxFee <= 0n)
|
|
1818
1826
|
throw new Error(`claimBurn: maxFee must be > 0, got ${maxFee}`);
|
|
1819
1827
|
const proof = contents.claim_proof;
|
|
1820
1828
|
const burnCommitment = fromHex(proof.commitment);
|
|
@@ -1831,49 +1839,101 @@ export class OotleAccount {
|
|
|
1831
1839
|
if (decrypted.value !== value) {
|
|
1832
1840
|
throw new Error(`claimBurn: burn proof states ${value} but the burn output holds ${decrypted.value}`);
|
|
1833
1841
|
}
|
|
1834
|
-
const claimedAmount = decrypted.value - maxFee;
|
|
1835
|
-
if (claimedAmount <= 0n) {
|
|
1836
|
-
throw new Error(`claimBurn: the burn (${decrypted.value}) does not cover maxFee (${maxFee})`);
|
|
1837
|
-
}
|
|
1838
|
-
const walletAddress = await this.getWalletAddress();
|
|
1839
|
-
const output = createOutput({ destination: walletAddress, amount: claimedAmount, resourceAddress: TARI_RESOURCE_ADDRESS, memo: toMemo(memo) });
|
|
1840
|
-
const { statement: outputsStatement, outputMask } = await crypto.generateOutputsStatement([output], maxFee);
|
|
1841
|
-
// The single input is the UTXO `ClaimBurn` mints in the same transaction; the instruction
|
|
1842
|
-
// itself authorises spending it, so it carries no witness.
|
|
1843
|
-
const inputsStatement = await crypto.buildInputsStatement([new StealthInput(burnCommitment)], 0n);
|
|
1844
|
-
const inputMask = await crypto.aggregateInputMasks([decrypted.mask]);
|
|
1845
|
-
const balanceProof = await crypto.generateBalanceProofSignature(inputMask, outputMask, inputsStatement.statementJson, outputsStatement.statementJson);
|
|
1846
|
-
const statement = new StealthTransferStatement(inputsStatement, outputsStatement, balanceProof);
|
|
1847
|
-
await crypto.validateTransfer(statement);
|
|
1848
|
-
const ownCommitment = outputsStatement.parsed().outputs[0].output.commitment;
|
|
1849
1842
|
const provider = await this.getProvider();
|
|
1850
|
-
const
|
|
1851
|
-
const
|
|
1852
|
-
|
|
1853
|
-
|
|
1854
|
-
|
|
1855
|
-
|
|
1856
|
-
|
|
1857
|
-
|
|
1858
|
-
}
|
|
1859
|
-
|
|
1860
|
-
|
|
1861
|
-
|
|
1862
|
-
|
|
1863
|
-
|
|
1864
|
-
|
|
1865
|
-
|
|
1866
|
-
|
|
1867
|
-
|
|
1868
|
-
|
|
1869
|
-
|
|
1870
|
-
|
|
1871
|
-
|
|
1872
|
-
|
|
1873
|
-
|
|
1843
|
+
const walletAddress = await this.getWalletAddress();
|
|
1844
|
+
const sealKeypair = { secret_key: stealthSecret, public_key: publicKeyFromSecretKey(stealthSecret) };
|
|
1845
|
+
// One claim transaction revealing `fee`. The output statement encodes the revealed amount, so
|
|
1846
|
+
// every fee needs its own statement and proofs.
|
|
1847
|
+
const buildClaim = async (fee, dryRun) => {
|
|
1848
|
+
const claimedAmount = decrypted.value - fee;
|
|
1849
|
+
if (claimedAmount <= 0n) {
|
|
1850
|
+
throw new Error(`claimBurn: the burn (${decrypted.value}) does not cover the claim fee (${fee})`);
|
|
1851
|
+
}
|
|
1852
|
+
const output = createOutput({ destination: walletAddress, amount: claimedAmount, resourceAddress: TARI_RESOURCE_ADDRESS, memo: toMemo(memo) });
|
|
1853
|
+
const { statement: outputsStatement, outputMask } = await crypto.generateOutputsStatement([output], fee);
|
|
1854
|
+
// The single input is the UTXO `ClaimBurn` mints in the same transaction; the instruction
|
|
1855
|
+
// itself authorises spending it, so it carries no witness.
|
|
1856
|
+
const inputsStatement = await crypto.buildInputsStatement([new StealthInput(burnCommitment)], 0n);
|
|
1857
|
+
const inputMask = await crypto.aggregateInputMasks([decrypted.mask]);
|
|
1858
|
+
const balanceProof = await crypto.generateBalanceProofSignature(inputMask, outputMask, inputsStatement.statementJson, outputsStatement.statementJson);
|
|
1859
|
+
const statement = new StealthTransferStatement(inputsStatement, outputsStatement, balanceProof);
|
|
1860
|
+
await crypto.validateTransfer(statement);
|
|
1861
|
+
const ownCommitment = outputsStatement.parsed().outputs[0].output.commitment;
|
|
1862
|
+
const maxEpoch = await resolveMaxEpoch(provider);
|
|
1863
|
+
const builder = TransactionBuilder.new(this.network, maxEpoch)
|
|
1864
|
+
.addFeeInstruction({ ClaimBurn: { claim: proof, output_data: { encrypted_data: contents.encrypted_data } } })
|
|
1865
|
+
.addFeeInstruction({
|
|
1866
|
+
StealthTransfer: {
|
|
1867
|
+
resource_address_ref: { Address: TARI_RESOURCE_ADDRESS },
|
|
1868
|
+
statement: { __ootleRawJson: statement.toCompactJson() },
|
|
1869
|
+
revealed_input_bucket: null,
|
|
1870
|
+
},
|
|
1871
|
+
})
|
|
1872
|
+
.addFeeInstruction({ PutLastInstructionOutputOnWorkspace: { key: 0 } })
|
|
1873
|
+
.addFeeInstruction({ PayFeeFromBucket: { bucket: { id: 0, offset: null } } })
|
|
1874
|
+
.addInput({ substate_id: TARI_RESOURCE_ADDRESS, version: null });
|
|
1875
|
+
// The seal key `s` is the transaction's only signer, so it must be authorized as the main
|
|
1876
|
+
// signer; the TS builder leaves that off by default.
|
|
1877
|
+
const unsignedBody = builder.buildUnsignedTransaction();
|
|
1878
|
+
unsignedBody.is_seal_signer_authorized = true;
|
|
1879
|
+
unsignedBody.dry_run = dryRun;
|
|
1880
|
+
const unsignedTx = await resolveTransaction(provider, unsignedBody);
|
|
1881
|
+
const signed = await signTransaction([], unsignedTx, sealKeypair);
|
|
1882
|
+
return { envelope: sealTransaction(signed), claimedAmount, ownCommitment };
|
|
1883
|
+
};
|
|
1884
|
+
let fee = maxFee ?? (await this.estimateClaimFee(await buildClaim(claimFeeProbe(decrypted.value), true)));
|
|
1885
|
+
let attempt = await buildClaim(fee, false);
|
|
1886
|
+
let transactionId = await submitTransaction(provider, attempt.envelope);
|
|
1887
|
+
let response;
|
|
1888
|
+
try {
|
|
1889
|
+
response = await withTimeout(pollTransactionResult(provider, transactionId), 90_000, "claiming the burn");
|
|
1890
|
+
}
|
|
1891
|
+
catch (e) {
|
|
1892
|
+
// A real run can meter a little differently from its dry run. When the rejection names the
|
|
1893
|
+
// fee it wanted, a measured fee is resubmitted once at exactly that; an explicit one is not.
|
|
1894
|
+
const required = maxFee === undefined ? requiredFeeFromRejection(e) : null;
|
|
1895
|
+
if (required === null || required <= fee)
|
|
1896
|
+
throw e;
|
|
1897
|
+
fee = required;
|
|
1898
|
+
attempt = await buildClaim(fee, false);
|
|
1899
|
+
transactionId = await submitTransaction(provider, attempt.envelope);
|
|
1900
|
+
response = await withTimeout(pollTransactionResult(provider, transactionId), 90_000, "claiming the burn");
|
|
1901
|
+
}
|
|
1874
1902
|
await recordKnownVersions(response);
|
|
1875
|
-
await recordKnownShieldedOutput(localAccountId(this.index), TARI_RESOURCE_ADDRESS, ownCommitment, claimedAmount, transactionId, memo);
|
|
1876
|
-
return { transactionId, claimedAmount, commitment: ownCommitment };
|
|
1903
|
+
await recordKnownShieldedOutput(localAccountId(this.index), TARI_RESOURCE_ADDRESS, attempt.ownCommitment, attempt.claimedAmount, transactionId, memo);
|
|
1904
|
+
return { transactionId, claimedAmount: attempt.claimedAmount, commitment: attempt.ownCommitment, fee };
|
|
1905
|
+
}
|
|
1906
|
+
/** Dry-runs a sealed claim and returns the fee it needs: what it was charged plus the allowance. */
|
|
1907
|
+
async estimateClaimFee(dryRun) {
|
|
1908
|
+
const res = await fetch(`${defaultIndexerUrl(this.network)}/transactions/dry-run`, {
|
|
1909
|
+
method: "POST",
|
|
1910
|
+
headers: { "Content-Type": "application/json" },
|
|
1911
|
+
body: JSON.stringify({ transaction: dryRun.envelope }),
|
|
1912
|
+
});
|
|
1913
|
+
const text = await res.text();
|
|
1914
|
+
let body;
|
|
1915
|
+
try {
|
|
1916
|
+
body = text ? JSON.parse(text) : undefined;
|
|
1917
|
+
}
|
|
1918
|
+
catch {
|
|
1919
|
+
// Not JSON — reported raw below.
|
|
1920
|
+
}
|
|
1921
|
+
if (!res.ok || body?.error || !body?.result) {
|
|
1922
|
+
throw new Error(`Could not estimate the claim fee: ${body?.error?.message ?? text ?? res.statusText}`);
|
|
1923
|
+
}
|
|
1924
|
+
const finalize = body.result.finalize;
|
|
1925
|
+
const outcome = finalize.result;
|
|
1926
|
+
if (typeof outcome === "object" && outcome !== null && "Reject" in outcome) {
|
|
1927
|
+
throw new Error(`Transaction ${finalize.transaction_hash ?? ""} was rejected: ${JSON.stringify(outcome.Reject)}`);
|
|
1928
|
+
}
|
|
1929
|
+
const breakdown = (finalize.fee_receipt?.cost_breakdown?.breakdown ?? {});
|
|
1930
|
+
let charged = 0n;
|
|
1931
|
+
for (const amount of Object.values(breakdown))
|
|
1932
|
+
if (amount !== undefined)
|
|
1933
|
+
charged += BigInt(amount);
|
|
1934
|
+
if (charged === 0n)
|
|
1935
|
+
throw new Error("Could not estimate the claim fee: the dry run reported no cost");
|
|
1936
|
+
return charged + FEE_ESTIMATE_ALLOWANCE;
|
|
1877
1937
|
}
|
|
1878
1938
|
/**
|
|
1879
1939
|
* This account's unspent stealth outputs, newest first, optionally filtered to one resource.
|
|
@@ -2428,6 +2488,25 @@ export async function recoverPendingShields(provider) {
|
|
|
2428
2488
|
}
|
|
2429
2489
|
}
|
|
2430
2490
|
}
|
|
2491
|
+
/**
|
|
2492
|
+
* `FEE_ESTIMATE_ALLOWANCE` in tari-ootle's `engine_types::fees`: a real run meters slightly
|
|
2493
|
+
* differently from its dry run (the fee amount's own encoding feeds the cost), and this bounds the
|
|
2494
|
+
* difference.
|
|
2495
|
+
*/
|
|
2496
|
+
const FEE_ESTIMATE_ALLOWANCE = 12n;
|
|
2497
|
+
/**
|
|
2498
|
+
* The fee revealed while dry-running a claim. A dry run never charges it, but its width feeds the
|
|
2499
|
+
* metered cost, so it sits well above any realistic claim cost while staying under the burn.
|
|
2500
|
+
*/
|
|
2501
|
+
function claimFeeProbe(burnValue) {
|
|
2502
|
+
const probe = 1000000n;
|
|
2503
|
+
return burnValue > probe ? probe : burnValue - 1n;
|
|
2504
|
+
}
|
|
2505
|
+
/** The fee named by an `InsufficientFeesPaid` rejection ("Required fees N but M paid"), if any. */
|
|
2506
|
+
function requiredFeeFromRejection(e) {
|
|
2507
|
+
const match = /Required fees (\d+) but \d+ paid/.exec(e instanceof Error ? e.message : String(e));
|
|
2508
|
+
return match ? BigInt(match[1]) : null;
|
|
2509
|
+
}
|
|
2431
2510
|
/**
|
|
2432
2511
|
* Persists a `ShieldedOutputRecord` for a commitment already known locally (see
|
|
2433
2512
|
* `extractOutputCommitment`'s doc comment for why this is preferred over scanning the finalized
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@chironbuilder/ootle-sdk",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.13",
|
|
4
4
|
"description": "Shared TypeScript client for Tari Ootle (L2): account derivation, balances, transactions, HTLCs, and stealth/confidential transfers — the account core behind Sapient and the Tari L1 web wallet's Ootle support.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|