@fepvenancio/stela-sdk 0.2.3 → 0.4.0

package/dist/index.d.cts

@@ -60,6 +60,23 @@ interface Inscription extends StoredInscription {
     id: string;
     status: InscriptionStatus;
 }
+/** Signed order for the matching engine (matches Cairo SignedOrder struct) */
+interface SignedOrder {
+    /** Order creator (could be borrower or lender) */
+    maker: string;
+    /** Zero address = open to anyone; nonzero = private OTC (only this address can fill) */
+    allowed_taker: string;
+    /** The inscription being offered for filling */
+    inscription_id: bigint;
+    /** Fill percentage being offered (in BPS, max 10,000) */
+    bps: bigint;
+    /** Unix timestamp deadline for order expiration */
+    deadline: bigint;
+    /** Maker nonce; bump via cancel_orders_by_nonce to invalidate batch */
+    nonce: string;
+    /** Minimum acceptable partial fill (0 = any amount accepted) */
+    min_fill_bps: bigint;
+}
 
 /** Row shape returned by the /api/inscriptions list endpoint */
 interface InscriptionRow {
@@ -192,8 +209,65 @@ interface TransferSingleEvent {
     transaction_hash: string;
     block_number: number;
 }
+/** OrderSettled event (emitted by settle()) */
+interface OrderSettledEvent {
+    type: 'OrderSettled';
+    inscription_id: bigint;
+    borrower: string;
+    lender: string;
+    relayer: string;
+    relayer_fee_amount: bigint;
+    transaction_hash: string;
+    block_number: number;
+}
+/** OrderFilled event (emitted by fill_signed_order()) */
+interface OrderFilledEvent {
+    type: 'OrderFilled';
+    inscription_id: bigint;
+    order_hash: string;
+    taker: string;
+    fill_bps: bigint;
+    total_filled_bps: bigint;
+    transaction_hash: string;
+    block_number: number;
+}
+/** OrderCancelled event (emitted by cancel_order()) */
+interface OrderCancelledEvent {
+    type: 'OrderCancelled';
+    order_hash: string;
+    maker: string;
+    transaction_hash: string;
+    block_number: number;
+}
+/** OrdersBulkCancelled event (emitted by cancel_orders_by_nonce()) */
+interface OrdersBulkCancelledEvent {
+    type: 'OrdersBulkCancelled';
+    maker: string;
+    new_min_nonce: string;
+    transaction_hash: string;
+    block_number: number;
+}
+/** PrivateSettled event (emitted by settle() when lender_commitment != 0) */
+interface PrivateSettledEvent {
+    type: 'PrivateSettled';
+    inscription_id: bigint;
+    lender_commitment: string;
+    shares_committed: bigint;
+    transaction_hash: string;
+    block_number: number;
+}
+/** PrivateSharesRedeemed event (emitted by private_redeem()) */
+interface PrivateSharesRedeemedEvent {
+    type: 'PrivateSharesRedeemed';
+    inscription_id: bigint;
+    nullifier: string;
+    shares: bigint;
+    recipient: string;
+    transaction_hash: string;
+    block_number: number;
+}
 /** Discriminated union of all Stela protocol events */
-type StelaEvent = InscriptionCreatedEvent | InscriptionSignedEvent | InscriptionCancelledEvent | InscriptionRepaidEvent | InscriptionLiquidatedEvent | SharesRedeemedEvent | TransferSingleEvent;
+type StelaEvent = InscriptionCreatedEvent | InscriptionSignedEvent | InscriptionCancelledEvent | InscriptionRepaidEvent | InscriptionLiquidatedEvent | SharesRedeemedEvent | TransferSingleEvent | OrderSettledEvent | OrderFilledEvent | OrderCancelledEvent | OrdersBulkCancelledEvent | PrivateSettledEvent | PrivateSharesRedeemedEvent;
 
 /** State of a locker account */
 interface LockerState {
@@ -301,6 +375,10 @@ declare const SELECTORS: {
     readonly InscriptionLiquidated: string;
     readonly SharesRedeemed: string;
     readonly TransferSingle: string;
+    readonly OrderSettled: string;
+    readonly OrderFilled: string;
+    readonly OrderCancelled: string;
+    readonly OrdersBulkCancelled: string;
 };
 
 /** Parse a single raw event into a typed StelaEvent. Returns null if unrecognized. */
@@ -340,9 +418,27 @@ declare function getInscriptionOrderTypedData(params: {
     nonce: bigint;
     chainId: string;
 }): TypedData;
+/**
+ * Build SNIP-12 TypedData for a private lend offer.
+ *
+ * Convenience wrapper around getLendOfferTypedData that sets lender to zero address
+ * and includes the deposit commitment. For private settlements, the lender is anonymous
+ * — the privacy pool's deposit commitment proves ownership instead.
+ */
+declare function getPrivateLendOfferTypedData(params: {
+    orderHash: string;
+    issuedDebtPercentage: bigint;
+    nonce: bigint;
+    chainId: string;
+    /** The deposit commitment from the privacy pool shield() call. */
+    depositCommitment: string;
+}): TypedData;
 /**
  * Build SNIP-12 TypedData for a lender's LendOffer.
  * The lender signs this off-chain to accept an order without gas.
+ *
+ * @param lenderCommitment - Privacy commitment. When non-zero, shares are committed to the
+ *   privacy pool's Merkle tree instead of minting ERC1155 to the lender. Defaults to '0'.
  */
 declare function getLendOfferTypedData(params: {
     orderHash: string;
@@ -350,6 +446,8 @@ declare function getLendOfferTypedData(params: {
     issuedDebtPercentage: bigint;
     nonce: bigint;
     chainId: string;
+    /** Privacy commitment (default '0' = non-private). */
+    lenderCommitment?: string;
 }): TypedData;
 
 /**
@@ -362,6 +460,72 @@ interface StoredSignature {
 declare function serializeSignature(sig: string[]): StoredSignature;
 declare function deserializeSignature(stored: StoredSignature): string[];
 
+/** A private share note — represents committed shares in the privacy pool. */
+interface PrivateNote {
+    /** The lender who owns these shares */
+    owner: string;
+    /** The inscription ID */
+    inscriptionId: bigint;
+    /** Number of shares */
+    shares: bigint;
+    /** Random salt for commitment uniqueness */
+    salt: string;
+    /** The commitment (Poseidon hash of above fields) */
+    commitment: string;
+}
+/** Request to privately redeem shares (matches Cairo PrivateRedeemRequest). */
+interface PrivateRedeemRequest {
+    /** Merkle root the proof was generated against */
+    root: string;
+    /** The inscription ID */
+    inscriptionId: bigint;
+    /** Number of shares being redeemed */
+    shares: bigint;
+    /** Nullifier (prevents double-spend) */
+    nullifier: string;
+    /** Change commitment (for partial redemption). '0' if full redemption. */
+    changeCommitment: string;
+    /** Recipient address for redeemed assets */
+    recipient: string;
+}
+
+/**
+ * Compute a note commitment matching the Cairo compute_commitment function.
+ *
+ * commitment = Poseidon(domain, owner, inscription_id.low, inscription_id.high,
+ *                       shares.low, shares.high, salt)
+ */
+declare function computeCommitment(owner: string, inscriptionId: bigint, shares: bigint, salt: string): string;
+/**
+ * Derive a nullifier from a commitment and the owner's secret.
+ * Matches Cairo: nullifier = Poseidon(domain, commitment, owner_secret)
+ */
+declare function computeNullifier(commitment: string, ownerSecret: string): string;
+/**
+ * Compute a Poseidon hash of two children (for Merkle tree internal nodes).
+ * Matches Cairo: hash_pair(left, right) = Poseidon(left, right)
+ */
+declare function hashPair(left: string, right: string): string;
+/**
+ * Generate a random salt for commitment uniqueness.
+ * Returns a hex-encoded felt252 (< 2^251).
+ */
+declare function generateSalt(): string;
+/**
+ * Compute a deposit commitment for the privacy pool's shield() call.
+ *
+ * This is the commitment that a depositor provides when shielding tokens into the privacy pool.
+ * It links the depositor, token, amount, and a secret salt so the deposit can later be consumed
+ * during private settlement.
+ *
+ * commitment = Poseidon(domain, depositor, token, amount.low, amount.high, salt)
+ */
+declare function computeDepositCommitment(depositor: string, token: string, amount: bigint, salt: bigint): string;
+/**
+ * Create a full private note: generates salt, computes commitment.
+ */
+declare function createPrivateNote(owner: string, inscriptionId: bigint, shares: bigint, salt?: string): PrivateNote;
+
 interface InscriptionClientOptions {
     stelaAddress: string;
     provider: RpcProvider;
@@ -378,12 +542,64 @@ declare class InscriptionClient {
     convertToShares(inscriptionId: bigint, percentage: bigint): Promise<bigint>;
     getNonce(address: string): Promise<bigint>;
     getRelayerFee(): Promise<bigint>;
+    getTreasury(): Promise<string>;
+    isPaused(): Promise<boolean>;
+    isOrderRegistered(orderHash: string): Promise<boolean>;
+    isOrderCancelled(orderHash: string): Promise<boolean>;
+    getFilledBps(orderHash: string): Promise<bigint>;
+    getMakerMinNonce(maker: string): Promise<string>;
     buildCreateInscription(params: InscriptionParams): Call;
     buildSignInscription(inscriptionId: bigint, bps: bigint): Call;
     buildCancelInscription(inscriptionId: bigint): Call;
     buildRepay(inscriptionId: bigint): Call;
     buildLiquidate(inscriptionId: bigint): Call;
     buildRedeem(inscriptionId: bigint, shares: bigint): Call;
+    buildPrivateRedeem(request: PrivateRedeemRequest, proof: string[]): Call;
+    /**
+     * Build a shield() call on the privacy pool contract.
+     * The depositor shields tokens into the pool, creating a commitment that can
+     * later be consumed during private settlement.
+     */
+    buildShieldDeposit(params: {
+        privacyPoolAddress: string;
+        token: string;
+        amount: bigint;
+        commitment: string;
+    }): Call;
+    /**
+     * Build a settle() call for private settlement.
+     *
+     * In a private settlement, the lender is zero address and the lender_commitment
+     * is the deposit commitment from the privacy pool. The contract skips lender
+     * signature verification and instead consumes the deposit from the privacy pool.
+     */
+    buildSettlePrivate(params: {
+        order: {
+            borrower: string;
+            debtHash: string;
+            interestHash: string;
+            collateralHash: string;
+            debtCount: number;
+            interestCount: number;
+            collateralCount: number;
+            duration: bigint;
+            deadline: bigint;
+            multiLender: boolean;
+            nonce: bigint;
+        };
+        debtAssets: Asset[];
+        interestAssets: Asset[];
+        collateralAssets: Asset[];
+        borrowerSig: string[];
+        offer: {
+            orderHash: string;
+            issuedDebtPercentage: bigint;
+            nonce: bigint;
+            /** The deposit commitment from the privacy pool. */
+            lenderCommitment: string;
+        };
+        lenderSig: string[];
+    }): Call;
     buildSettle(params: {
         order: {
             borrower: string;
@@ -407,9 +623,14 @@ declare class InscriptionClient {
             lender: string;
             issuedDebtPercentage: bigint;
             nonce: bigint;
+            /** Privacy commitment. When non-zero, shares go to privacy pool. Default '0'. */
+            lenderCommitment?: string;
         };
         lenderSig: string[];
     }): Call;
+    buildFillSignedOrder(order: SignedOrder, signature: string[], fillBps: bigint): Call;
+    buildCancelOrder(order: SignedOrder): Call;
+    buildCancelOrdersByNonce(minNonce: string): Call;
     /**
      * Execute one or more calls via the connected account.
      * Pass approval calls to bundle ERC20 approve + protocol call atomically.
@@ -435,6 +656,18 @@ declare class InscriptionClient {
     redeem(inscriptionId: bigint, shares: bigint): Promise<{
         transaction_hash: string;
     }>;
+    privateRedeem(request: PrivateRedeemRequest, proof: string[]): Promise<{
+        transaction_hash: string;
+    }>;
+    fillSignedOrder(order: SignedOrder, signature: string[], fillBps: bigint, approvals?: Call[]): Promise<{
+        transaction_hash: string;
+    }>;
+    cancelOrder(order: SignedOrder): Promise<{
+        transaction_hash: string;
+    }>;
+    cancelOrdersByNonce(minNonce: string): Promise<{
+        transaction_hash: string;
+    }>;
 }
 
 interface ShareClientOptions {
@@ -575,4 +808,4 @@ declare class StelaSdk {
     constructor(opts: StelaSdkOptions);
 }
 
-export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, type ApiClientOptions, type ApiDetailResponse, ApiError, type ApiListResponse, type Asset, type AssetRow, type AssetType, type Call, type Inscription, type InscriptionCancelledEvent, InscriptionClient, type InscriptionClientOptions, type InscriptionCreatedEvent, type InscriptionEventRow, type InscriptionLiquidatedEvent, type InscriptionParams, type InscriptionRepaidEvent, type InscriptionRow, type InscriptionSignedEvent, type InscriptionStatus, type ListInscriptionsParams, type LockerCall, LockerClient, type LockerInfo, type LockerState, MAX_BPS, type Network, type RawEvent, SELECTORS, STATUS_LABELS, STELA_ADDRESS, type ShareBalance, ShareClient, type ShareClientOptions, type SharesRedeemedEvent, type StatusInput, type StelaEvent, StelaSdk, type StelaSdkOptions, type StoredInscription, type StoredSignature, TOKENS, type TokenInfo, type TransferSingleEvent, type TreasuryAsset, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeStatus, convertToShares, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, getInscriptionOrderTypedData, getLendOfferTypedData, getTokensForNetwork, hashAssets, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };
+export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, type ApiClientOptions, type ApiDetailResponse, ApiError, type ApiListResponse, type Asset, type AssetRow, type AssetType, type Call, type Inscription, type InscriptionCancelledEvent, InscriptionClient, type InscriptionClientOptions, type InscriptionCreatedEvent, type InscriptionEventRow, type InscriptionLiquidatedEvent, type InscriptionParams, type InscriptionRepaidEvent, type InscriptionRow, type InscriptionSignedEvent, type InscriptionStatus, type ListInscriptionsParams, type LockerCall, LockerClient, type LockerInfo, type LockerState, MAX_BPS, type Network, type OrderCancelledEvent, type OrderFilledEvent, type OrderSettledEvent, type OrdersBulkCancelledEvent, type PrivateNote, type PrivateRedeemRequest, type PrivateSettledEvent, type PrivateSharesRedeemedEvent, type RawEvent, SELECTORS, STATUS_LABELS, STELA_ADDRESS, type ShareBalance, ShareClient, type ShareClientOptions, type SharesRedeemedEvent, type SignedOrder, type StatusInput, type StelaEvent, StelaSdk, type StelaSdkOptions, type StoredInscription, type StoredSignature, TOKENS, type TokenInfo, type TransferSingleEvent, type TreasuryAsset, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeCommitment, computeDepositCommitment, computeNullifier, computeStatus, convertToShares, createPrivateNote, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, generateSalt, getInscriptionOrderTypedData, getLendOfferTypedData, getPrivateLendOfferTypedData, getTokensForNetwork, hashAssets, hashPair, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };

package/dist/index.d.ts

@@ -60,6 +60,23 @@ interface Inscription extends StoredInscription {
     id: string;
     status: InscriptionStatus;
 }
+/** Signed order for the matching engine (matches Cairo SignedOrder struct) */
+interface SignedOrder {
+    /** Order creator (could be borrower or lender) */
+    maker: string;
+    /** Zero address = open to anyone; nonzero = private OTC (only this address can fill) */
+    allowed_taker: string;
+    /** The inscription being offered for filling */
+    inscription_id: bigint;
+    /** Fill percentage being offered (in BPS, max 10,000) */
+    bps: bigint;
+    /** Unix timestamp deadline for order expiration */
+    deadline: bigint;
+    /** Maker nonce; bump via cancel_orders_by_nonce to invalidate batch */
+    nonce: string;
+    /** Minimum acceptable partial fill (0 = any amount accepted) */
+    min_fill_bps: bigint;
+}
 
 /** Row shape returned by the /api/inscriptions list endpoint */
 interface InscriptionRow {
@@ -192,8 +209,65 @@ interface TransferSingleEvent {
     transaction_hash: string;
     block_number: number;
 }
+/** OrderSettled event (emitted by settle()) */
+interface OrderSettledEvent {
+    type: 'OrderSettled';
+    inscription_id: bigint;
+    borrower: string;
+    lender: string;
+    relayer: string;
+    relayer_fee_amount: bigint;
+    transaction_hash: string;
+    block_number: number;
+}
+/** OrderFilled event (emitted by fill_signed_order()) */
+interface OrderFilledEvent {
+    type: 'OrderFilled';
+    inscription_id: bigint;
+    order_hash: string;
+    taker: string;
+    fill_bps: bigint;
+    total_filled_bps: bigint;
+    transaction_hash: string;
+    block_number: number;
+}
+/** OrderCancelled event (emitted by cancel_order()) */
+interface OrderCancelledEvent {
+    type: 'OrderCancelled';
+    order_hash: string;
+    maker: string;
+    transaction_hash: string;
+    block_number: number;
+}
+/** OrdersBulkCancelled event (emitted by cancel_orders_by_nonce()) */
+interface OrdersBulkCancelledEvent {
+    type: 'OrdersBulkCancelled';
+    maker: string;
+    new_min_nonce: string;
+    transaction_hash: string;
+    block_number: number;
+}
+/** PrivateSettled event (emitted by settle() when lender_commitment != 0) */
+interface PrivateSettledEvent {
+    type: 'PrivateSettled';
+    inscription_id: bigint;
+    lender_commitment: string;
+    shares_committed: bigint;
+    transaction_hash: string;
+    block_number: number;
+}
+/** PrivateSharesRedeemed event (emitted by private_redeem()) */
+interface PrivateSharesRedeemedEvent {
+    type: 'PrivateSharesRedeemed';
+    inscription_id: bigint;
+    nullifier: string;
+    shares: bigint;
+    recipient: string;
+    transaction_hash: string;
+    block_number: number;
+}
 /** Discriminated union of all Stela protocol events */
-type StelaEvent = InscriptionCreatedEvent | InscriptionSignedEvent | InscriptionCancelledEvent | InscriptionRepaidEvent | InscriptionLiquidatedEvent | SharesRedeemedEvent | TransferSingleEvent;
+type StelaEvent = InscriptionCreatedEvent | InscriptionSignedEvent | InscriptionCancelledEvent | InscriptionRepaidEvent | InscriptionLiquidatedEvent | SharesRedeemedEvent | TransferSingleEvent | OrderSettledEvent | OrderFilledEvent | OrderCancelledEvent | OrdersBulkCancelledEvent | PrivateSettledEvent | PrivateSharesRedeemedEvent;
 
 /** State of a locker account */
 interface LockerState {
@@ -301,6 +375,10 @@ declare const SELECTORS: {
     readonly InscriptionLiquidated: string;
     readonly SharesRedeemed: string;
     readonly TransferSingle: string;
+    readonly OrderSettled: string;
+    readonly OrderFilled: string;
+    readonly OrderCancelled: string;
+    readonly OrdersBulkCancelled: string;
 };
 
 /** Parse a single raw event into a typed StelaEvent. Returns null if unrecognized. */
@@ -340,9 +418,27 @@ declare function getInscriptionOrderTypedData(params: {
     nonce: bigint;
     chainId: string;
 }): TypedData;
+/**
+ * Build SNIP-12 TypedData for a private lend offer.
+ *
+ * Convenience wrapper around getLendOfferTypedData that sets lender to zero address
+ * and includes the deposit commitment. For private settlements, the lender is anonymous
+ * — the privacy pool's deposit commitment proves ownership instead.
+ */
+declare function getPrivateLendOfferTypedData(params: {
+    orderHash: string;
+    issuedDebtPercentage: bigint;
+    nonce: bigint;
+    chainId: string;
+    /** The deposit commitment from the privacy pool shield() call. */
+    depositCommitment: string;
+}): TypedData;
 /**
  * Build SNIP-12 TypedData for a lender's LendOffer.
  * The lender signs this off-chain to accept an order without gas.
+ *
+ * @param lenderCommitment - Privacy commitment. When non-zero, shares are committed to the
+ *   privacy pool's Merkle tree instead of minting ERC1155 to the lender. Defaults to '0'.
  */
 declare function getLendOfferTypedData(params: {
     orderHash: string;
@@ -350,6 +446,8 @@ declare function getLendOfferTypedData(params: {
     issuedDebtPercentage: bigint;
     nonce: bigint;
     chainId: string;
+    /** Privacy commitment (default '0' = non-private). */
+    lenderCommitment?: string;
 }): TypedData;
 
 /**
@@ -362,6 +460,72 @@ interface StoredSignature {
 declare function serializeSignature(sig: string[]): StoredSignature;
 declare function deserializeSignature(stored: StoredSignature): string[];
 
+/** A private share note — represents committed shares in the privacy pool. */
+interface PrivateNote {
+    /** The lender who owns these shares */
+    owner: string;
+    /** The inscription ID */
+    inscriptionId: bigint;
+    /** Number of shares */
+    shares: bigint;
+    /** Random salt for commitment uniqueness */
+    salt: string;
+    /** The commitment (Poseidon hash of above fields) */
+    commitment: string;
+}
+/** Request to privately redeem shares (matches Cairo PrivateRedeemRequest). */
+interface PrivateRedeemRequest {
+    /** Merkle root the proof was generated against */
+    root: string;
+    /** The inscription ID */
+    inscriptionId: bigint;
+    /** Number of shares being redeemed */
+    shares: bigint;
+    /** Nullifier (prevents double-spend) */
+    nullifier: string;
+    /** Change commitment (for partial redemption). '0' if full redemption. */
+    changeCommitment: string;
+    /** Recipient address for redeemed assets */
+    recipient: string;
+}
+
+/**
+ * Compute a note commitment matching the Cairo compute_commitment function.
+ *
+ * commitment = Poseidon(domain, owner, inscription_id.low, inscription_id.high,
+ *                       shares.low, shares.high, salt)
+ */
+declare function computeCommitment(owner: string, inscriptionId: bigint, shares: bigint, salt: string): string;
+/**
+ * Derive a nullifier from a commitment and the owner's secret.
+ * Matches Cairo: nullifier = Poseidon(domain, commitment, owner_secret)
+ */
+declare function computeNullifier(commitment: string, ownerSecret: string): string;
+/**
+ * Compute a Poseidon hash of two children (for Merkle tree internal nodes).
+ * Matches Cairo: hash_pair(left, right) = Poseidon(left, right)
+ */
+declare function hashPair(left: string, right: string): string;
+/**
+ * Generate a random salt for commitment uniqueness.
+ * Returns a hex-encoded felt252 (< 2^251).
+ */
+declare function generateSalt(): string;
+/**
+ * Compute a deposit commitment for the privacy pool's shield() call.
+ *
+ * This is the commitment that a depositor provides when shielding tokens into the privacy pool.
+ * It links the depositor, token, amount, and a secret salt so the deposit can later be consumed
+ * during private settlement.
+ *
+ * commitment = Poseidon(domain, depositor, token, amount.low, amount.high, salt)
+ */
+declare function computeDepositCommitment(depositor: string, token: string, amount: bigint, salt: bigint): string;
+/**
+ * Create a full private note: generates salt, computes commitment.
+ */
+declare function createPrivateNote(owner: string, inscriptionId: bigint, shares: bigint, salt?: string): PrivateNote;
+
 interface InscriptionClientOptions {
     stelaAddress: string;
     provider: RpcProvider;
@@ -378,12 +542,64 @@ declare class InscriptionClient {
     convertToShares(inscriptionId: bigint, percentage: bigint): Promise<bigint>;
     getNonce(address: string): Promise<bigint>;
     getRelayerFee(): Promise<bigint>;
+    getTreasury(): Promise<string>;
+    isPaused(): Promise<boolean>;
+    isOrderRegistered(orderHash: string): Promise<boolean>;
+    isOrderCancelled(orderHash: string): Promise<boolean>;
+    getFilledBps(orderHash: string): Promise<bigint>;
+    getMakerMinNonce(maker: string): Promise<string>;
     buildCreateInscription(params: InscriptionParams): Call;
     buildSignInscription(inscriptionId: bigint, bps: bigint): Call;
     buildCancelInscription(inscriptionId: bigint): Call;
     buildRepay(inscriptionId: bigint): Call;
     buildLiquidate(inscriptionId: bigint): Call;
     buildRedeem(inscriptionId: bigint, shares: bigint): Call;
+    buildPrivateRedeem(request: PrivateRedeemRequest, proof: string[]): Call;
+    /**
+     * Build a shield() call on the privacy pool contract.
+     * The depositor shields tokens into the pool, creating a commitment that can
+     * later be consumed during private settlement.
+     */
+    buildShieldDeposit(params: {
+        privacyPoolAddress: string;
+        token: string;
+        amount: bigint;
+        commitment: string;
+    }): Call;
+    /**
+     * Build a settle() call for private settlement.
+     *
+     * In a private settlement, the lender is zero address and the lender_commitment
+     * is the deposit commitment from the privacy pool. The contract skips lender
+     * signature verification and instead consumes the deposit from the privacy pool.
+     */
+    buildSettlePrivate(params: {
+        order: {
+            borrower: string;
+            debtHash: string;
+            interestHash: string;
+            collateralHash: string;
+            debtCount: number;
+            interestCount: number;
+            collateralCount: number;
+            duration: bigint;
+            deadline: bigint;
+            multiLender: boolean;
+            nonce: bigint;
+        };
+        debtAssets: Asset[];
+        interestAssets: Asset[];
+        collateralAssets: Asset[];
+        borrowerSig: string[];
+        offer: {
+            orderHash: string;
+            issuedDebtPercentage: bigint;
+            nonce: bigint;
+            /** The deposit commitment from the privacy pool. */
+            lenderCommitment: string;
+        };
+        lenderSig: string[];
+    }): Call;
     buildSettle(params: {
         order: {
             borrower: string;
@@ -407,9 +623,14 @@ declare class InscriptionClient {
             lender: string;
             issuedDebtPercentage: bigint;
             nonce: bigint;
+            /** Privacy commitment. When non-zero, shares go to privacy pool. Default '0'. */
+            lenderCommitment?: string;
         };
         lenderSig: string[];
     }): Call;
+    buildFillSignedOrder(order: SignedOrder, signature: string[], fillBps: bigint): Call;
+    buildCancelOrder(order: SignedOrder): Call;
+    buildCancelOrdersByNonce(minNonce: string): Call;
     /**
      * Execute one or more calls via the connected account.
      * Pass approval calls to bundle ERC20 approve + protocol call atomically.
@@ -435,6 +656,18 @@ declare class InscriptionClient {
     redeem(inscriptionId: bigint, shares: bigint): Promise<{
         transaction_hash: string;
     }>;
+    privateRedeem(request: PrivateRedeemRequest, proof: string[]): Promise<{
+        transaction_hash: string;
+    }>;
+    fillSignedOrder(order: SignedOrder, signature: string[], fillBps: bigint, approvals?: Call[]): Promise<{
+        transaction_hash: string;
+    }>;
+    cancelOrder(order: SignedOrder): Promise<{
+        transaction_hash: string;
+    }>;
+    cancelOrdersByNonce(minNonce: string): Promise<{
+        transaction_hash: string;
+    }>;
 }
 
 interface ShareClientOptions {
@@ -575,4 +808,4 @@ declare class StelaSdk {
     constructor(opts: StelaSdkOptions);
 }
 
-export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, type ApiClientOptions, type ApiDetailResponse, ApiError, type ApiListResponse, type Asset, type AssetRow, type AssetType, type Call, type Inscription, type InscriptionCancelledEvent, InscriptionClient, type InscriptionClientOptions, type InscriptionCreatedEvent, type InscriptionEventRow, type InscriptionLiquidatedEvent, type InscriptionParams, type InscriptionRepaidEvent, type InscriptionRow, type InscriptionSignedEvent, type InscriptionStatus, type ListInscriptionsParams, type LockerCall, LockerClient, type LockerInfo, type LockerState, MAX_BPS, type Network, type RawEvent, SELECTORS, STATUS_LABELS, STELA_ADDRESS, type ShareBalance, ShareClient, type ShareClientOptions, type SharesRedeemedEvent, type StatusInput, type StelaEvent, StelaSdk, type StelaSdkOptions, type StoredInscription, type StoredSignature, TOKENS, type TokenInfo, type TransferSingleEvent, type TreasuryAsset, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeStatus, convertToShares, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, getInscriptionOrderTypedData, getLendOfferTypedData, getTokensForNetwork, hashAssets, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };
+export { ASSET_TYPE_ENUM, ASSET_TYPE_NAMES, ApiClient, type ApiClientOptions, type ApiDetailResponse, ApiError, type ApiListResponse, type Asset, type AssetRow, type AssetType, type Call, type Inscription, type InscriptionCancelledEvent, InscriptionClient, type InscriptionClientOptions, type InscriptionCreatedEvent, type InscriptionEventRow, type InscriptionLiquidatedEvent, type InscriptionParams, type InscriptionRepaidEvent, type InscriptionRow, type InscriptionSignedEvent, type InscriptionStatus, type ListInscriptionsParams, type LockerCall, LockerClient, type LockerInfo, type LockerState, MAX_BPS, type Network, type OrderCancelledEvent, type OrderFilledEvent, type OrderSettledEvent, type OrdersBulkCancelledEvent, type PrivateNote, type PrivateRedeemRequest, type PrivateSettledEvent, type PrivateSharesRedeemedEvent, type RawEvent, SELECTORS, STATUS_LABELS, STELA_ADDRESS, type ShareBalance, ShareClient, type ShareClientOptions, type SharesRedeemedEvent, type SignedOrder, type StatusInput, type StelaEvent, StelaSdk, type StelaSdkOptions, type StoredInscription, type StoredSignature, TOKENS, type TokenInfo, type TransferSingleEvent, type TreasuryAsset, VALID_STATUSES, VIRTUAL_SHARE_OFFSET, addressesEqual, calculateFeeShares, computeCommitment, computeDepositCommitment, computeNullifier, computeStatus, convertToShares, createPrivateNote, deserializeSignature, findTokenByAddress, formatAddress, formatDuration, formatTimestamp, formatTokenValue, fromU256, generateSalt, getInscriptionOrderTypedData, getLendOfferTypedData, getPrivateLendOfferTypedData, getTokensForNetwork, hashAssets, hashPair, inscriptionIdToHex, normalizeAddress, parseAmount, parseEvent, parseEvents, resolveNetwork, scaleByPercentage, serializeSignature, sharesToPercentage, toHex, toU256 };