@vultisig/rujira 12.0.0 → 13.0.0

package/dist/ccl/quadratic.js

@@ -0,0 +1,52 @@
+// Symmetric weight: w(p) = 1 + σ·(1 - (2·(p - p_m)/Δp)²)
+// s-space: w(s²) = C₀ + C₂·s² + C₄·s⁴
+import { Ccl } from './base.js';
+export class CclQuadratic extends Ccl {
+    constructor(high, low, sigma) {
+        super(high, low);
+        const pM = (high + low) / 2;
+        const deltaP = high - low;
+        if (deltaP === 0) {
+            this.c0 = 1;
+            this.c2 = 0;
+            this.c4 = 0;
+        }
+        else {
+            const dp2 = deltaP * deltaP;
+            this.c0 = 1 + sigma - (4 * sigma * pM * pM) / dp2;
+            this.c2 = (8 * sigma * pM) / dp2;
+            this.c4 = (-4 * sigma) / dp2;
+        }
+    }
+    // Y(s) = C₀·(s-s_a) + C₂·(s³-s_a³)/3 + C₄·(s⁵-s_a⁵)/5
+    yAt(s) {
+        const s3 = s * s * s;
+        const sA3 = this.sA * this.sA * this.sA;
+        const s5 = s3 * s * s;
+        const sA5 = sA3 * this.sA * this.sA;
+        return this.c0 * (s - this.sA) + (this.c2 / 3) * (s3 - sA3) + (this.c4 / 5) * (s5 - sA5);
+    }
+    // X(s) = C₀·(1/s - 1/s_b) + C₂·(s_b - s) + C₄·(s_b³ - s³)/3
+    xAt(s) {
+        if (s === 0)
+            return 0;
+        const s3 = s * s * s;
+        const sB3 = this.sB * this.sB * this.sB;
+        return this.c0 * (1 / s - 1 / this.sB) + this.c2 * (this.sB - s) + (this.c4 / 3) * (sB3 - s3);
+    }
+    // Y'(s) = C₀ + C₂·s² + C₄·s⁴
+    yPrime(s) {
+        const s2 = s * s;
+        return this.c0 + this.c2 * s2 + this.c4 * s2 * s2;
+    }
+    // X'(s) = -C₀/s² - C₂ - C₄·s²
+    xPrime(s) {
+        const s2 = s * s;
+        if (s2 === 0)
+            return 0;
+        return -this.c0 / s2 - this.c2 - this.c4 * s2;
+    }
+    weight(p) {
+        return this.c0 + this.c2 * p + this.c4 * p * p;
+    }
+}

package/dist/ccl/types.d.ts

@@ -0,0 +1,29 @@
+export type CclModel = 'quadratic' | 'linear';
+export type CclRangeConfig = {
+    high: number;
+    low: number;
+    price: number;
+    sigma: number;
+    spread: number;
+    delta: number;
+    model?: CclModel;
+};
+export type CclDistributionBucket = {
+    pStart: number;
+    pEnd: number;
+    pMid: number;
+    weight: number;
+    pct: number;
+    side: 'ask' | 'bid';
+};
+export type CclDistribution = {
+    asks: CclDistributionBucket[];
+    bids: CclDistributionBucket[];
+    price: number;
+    askPrice: number;
+    bidPrice: number;
+    avgAskFillPrice: number;
+    avgBidFillPrice: number;
+    balanceRatio: number | null;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/ccl/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ccl/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE7C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,QAAQ,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,KAAK,GAAG,KAAK,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,qBAAqB,EAAE,CAAA;IAC7B,IAAI,EAAE,qBAAqB,EAAE,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAAA"}

package/dist/ccl/types.js

@@ -0,0 +1 @@
+export {};

package/dist/client.d.ts

@@ -6,7 +6,7 @@ import { RujiraAssets } from './modules/assets.js';
 import { RujiraDeposit } from './modules/deposit.js';
 import { RujiraGhost } from './modules/ghost.js';
 import { RujiraOrderbook } from './modules/orderbook.js';
-import { RujiraPerps } from './modules/perps.js';
+import { RujiraRange } from './modules/range.js';
 import { RujiraStaking } from './modules/staking.js';
 import { RujiraSwap, type RujiraSwapOptions } from './modules/swap.js';
 import { RujiraWithdraw } from './modules/withdraw.js';
@@ -32,7 +32,7 @@ export declare class RujiraClient {
     readonly withdraw: RujiraWithdraw;
     readonly staking: RujiraStaking;
     readonly ghost: RujiraGhost;
-    readonly perps: RujiraPerps;
+    readonly range: RujiraRange;
     readonly discovery: RujiraDiscovery;
     private queryClient;
     private stargateClient;

package/dist/client.js

@@ -8,7 +8,7 @@ import { RujiraAssets } from './modules/assets.js';
 import { RujiraDeposit } from './modules/deposit.js';
 import { RujiraGhost } from './modules/ghost.js';
 import { RujiraOrderbook } from './modules/orderbook.js';
-import { RujiraPerps } from './modules/perps.js';
+import { RujiraRange } from './modules/range.js';
 import { RujiraStaking } from './modules/staking.js';
 import { RujiraSwap } from './modules/swap.js';
 import { RujiraWithdraw } from './modules/withdraw.js';
@@ -42,7 +42,7 @@ export class RujiraClient {
         this.withdraw = new RujiraWithdraw(this);
         this.staking = new RujiraStaking(this);
         this.ghost = new RujiraGhost(this);
-        this.perps = new RujiraPerps(this);
+        this.range = new RujiraRange(this);
         this.discovery = new RujiraDiscovery({
             rpcEndpoint: this.config.rpcEndpoint,
             debug: this.debug,

package/dist/errors.d.ts

@@ -15,6 +15,7 @@ export declare enum RujiraErrorCode {
     INVALID_ADDRESS = "INVALID_ADDRESS",
     INVALID_PAIR = "INVALID_PAIR",
     INVALID_SLIPPAGE = "INVALID_SLIPPAGE",
+    INVALID_PARAMS = "INVALID_PARAMS",
     INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
     INSUFFICIENT_GAS = "INSUFFICIENT_GAS",
     NO_ROUTE = "NO_ROUTE",

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,eAAe;IAEzB,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAG/B,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IAGrC,oBAAoB,yBAAyB;IAC7C,gBAAgB,qBAAqB;IAGrC,QAAQ,aAAa;IACrB,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;IAC/B,qBAAqB,0BAA0B;IAG/C,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,oBAAoB,yBAAyB;IAG7C,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAG7B,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IAGjC,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,2CAA2C;IAC3C,SAAgB,IAAI,EAAE,eAAe,CAAA;IACrC,+BAA+B;IAC/B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjC,sCAAsC;IACtC,SAAgB,SAAS,EAAE,OAAO,CAAA;gBAEtB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,UAAQ;IAaxF;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlC;AA+CD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKxD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,kBAAgC,GAAG,WAAW,CA6DlG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,eAAe;IAEzB,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAG/B,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IAGjC,oBAAoB,yBAAyB;IAC7C,gBAAgB,qBAAqB;IAGrC,QAAQ,aAAa;IACrB,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;IAC/B,qBAAqB,0BAA0B;IAG/C,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,oBAAoB,yBAAyB;IAG7C,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAG7B,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IAGjC,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,2CAA2C;IAC3C,SAAgB,IAAI,EAAE,eAAe,CAAA;IACrC,+BAA+B;IAC/B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjC,sCAAsC;IACtC,SAAgB,SAAS,EAAE,OAAO,CAAA;gBAEtB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,UAAQ;IAaxF;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlC;AAgDD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKxD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,kBAAgC,GAAG,WAAW,CA6DlG"}

package/dist/errors.js

@@ -18,6 +18,7 @@ export var RujiraErrorCode;
     RujiraErrorCode["INVALID_ADDRESS"] = "INVALID_ADDRESS";
     RujiraErrorCode["INVALID_PAIR"] = "INVALID_PAIR";
     RujiraErrorCode["INVALID_SLIPPAGE"] = "INVALID_SLIPPAGE";
+    RujiraErrorCode["INVALID_PARAMS"] = "INVALID_PARAMS";
     // Balance errors
     RujiraErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
     RujiraErrorCode["INSUFFICIENT_GAS"] = "INSUFFICIENT_GAS";
@@ -92,6 +93,7 @@ const USER_FRIENDLY_MESSAGES = {
     [RujiraErrorCode.INVALID_ADDRESS]: 'Invalid address format.',
     [RujiraErrorCode.INVALID_PAIR]: 'Trading pair not found or not supported.',
     [RujiraErrorCode.INVALID_SLIPPAGE]: 'Invalid slippage tolerance. Must be between 0.01% and 50%.',
+    [RujiraErrorCode.INVALID_PARAMS]: 'Invalid parameters. Please check the input and try again.',
     [RujiraErrorCode.INSUFFICIENT_BALANCE]: 'Insufficient balance for this transaction.',
     [RujiraErrorCode.INSUFFICIENT_GAS]: 'Insufficient RUNE for gas fees.',
     [RujiraErrorCode.NO_ROUTE]: 'No swap route available for this pair.',

package/dist/index.d.ts

@@ -32,12 +32,14 @@ export * from './errors.js';
 export * from './types.js';
 export type { RujiraClientOptions } from './client.js';
 export { RujiraClient } from './client.js';
+export type { CclDistribution, CclDistributionBucket, CclModel, CclRangeConfig } from './ccl/index.js';
+export { CclLinear, CclQuadratic, createCcl, generateCclDistribution } from './ccl/index.js';
 export { RujiraAssets } from './modules/assets.js';
 export type { GhostTransactionParams, GhostVaultInfo, GhostVaultStatus } from './modules/ghost.js';
 export { RujiraGhost } from './modules/ghost.js';
 export { RujiraOrderbook } from './modules/orderbook.js';
-export type { PerpsMarket, PerpsTransactionParams } from './modules/perps.js';
-export { RujiraPerps } from './modules/perps.js';
+export type { RangeAnalytics, ClaimParams as RangeClaimParams, RangeConfig, CreatePositionParams as RangeCreatePositionParams, DepositParams as RangeDepositParams, FinPair as RangeFinPair, RangeMultiTransactionParams, RangePosition, RangeTransactionParams, TransferParams as RangeTransferParams, WithdrawAllParams as RangeWithdrawAllParams, WithdrawParams as RangeWithdrawParams, } from './modules/range.js';
+export { RANGE_APR_SCALE, RANGE_CONFIG_DECIMALS, RANGE_MOIC_SCALE, RANGE_WITHDRAW_SHARE_DECIMALS, RujiraRange, } from './modules/range.js';
 export type { StakeParams, StakeTransactionParams, StakingPosition, UnstakeParams } from './modules/staking.js';
 export { RujiraStaking } from './modules/staking.js';
 export { RujiraSwap } from './modules/swap.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,YAAY,EACV,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,UAAU,EACV,QAAQ,GACT,MAAM,kBAAkB,CAAA;AAGzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAG1B,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAC/G,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9C,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAGtE,cAAc,mBAAmB,CAAA;AAGjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,YAAY,EACV,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,UAAU,EACV,QAAQ,GACT,MAAM,kBAAkB,CAAA;AAGzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAG1B,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACtG,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,YAAY,EACV,cAAc,EACd,WAAW,IAAI,gBAAgB,EAC/B,WAAW,EACX,oBAAoB,IAAI,yBAAyB,EACjD,aAAa,IAAI,kBAAkB,EACnC,OAAO,IAAI,YAAY,EACvB,2BAA2B,EAC3B,aAAa,EACb,sBAAsB,EACtB,cAAc,IAAI,mBAAmB,EACrC,iBAAiB,IAAI,sBAAsB,EAC3C,cAAc,IAAI,mBAAmB,GACtC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,6BAA6B,EAC7B,WAAW,GACZ,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAC/G,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9C,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAGtE,cAAc,mBAAmB,CAAA;AAGjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -31,11 +31,11 @@ export * from './config.js';
 export * from './errors.js';
 export * from './types.js';
 export { RujiraClient } from './client.js';
-// Module exports
+export { CclLinear, CclQuadratic, createCcl, generateCclDistribution } from './ccl/index.js';
 export { RujiraAssets } from './modules/assets.js';
 export { RujiraGhost } from './modules/ghost.js';
 export { RujiraOrderbook } from './modules/orderbook.js';
-export { RujiraPerps } from './modules/perps.js';
+export { RANGE_APR_SCALE, RANGE_CONFIG_DECIMALS, RANGE_MOIC_SCALE, RANGE_WITHDRAW_SHARE_DECIMALS, RujiraRange, } from './modules/range.js';
 export { RujiraStaking } from './modules/staking.js';
 export { RujiraSwap } from './modules/swap.js';
 export { VultisigRujiraProvider } from './signer/vultisig-provider.js';

package/dist/modules/range.d.ts

@@ -0,0 +1,167 @@
+/**
+ * RUJI Trade Custom Concentrated Liquidity (CCL) — range positions.
+ *
+ * CCL positions live on the rujira-fin orderbook pair contract (v1.2+),
+ * NOT on the BOW AMM contract. Each position is identified by `idx` (bigint
+ * as string, scoped per pair). Users create a position with a price range
+ * (high/low), spread, skew, and fee, then the position automatically market-
+ * makes across the range, compounding and/or accruing claimable yield.
+ *
+ * Message shapes mirror the upstream rujira-ui `Range.tsx` / `RangeManage.tsx`
+ * verbatim — any drift there is load-bearing and must be updated in lockstep.
+ *
+ * @module modules/range
+ */
+import type { Coin } from '@cosmjs/proto-signing';
+import type { RujiraClient } from '../client.js';
+/** Scale of MOIC and DPI fields in analytics (divide raw bigint by this). */
+export declare const RANGE_MOIC_SCALE = 1000000000000;
+/** Scale of APR field in analytics (divide raw bigint by this). */
+export declare const RANGE_APR_SCALE = 10000000000;
+/** Fractional digits used by config Decimal fields (high/low/spread/skew/fee). */
+export declare const RANGE_CONFIG_DECIMALS = 12;
+/** Fractional digits used by the withdraw share parameter. */
+export declare const RANGE_WITHDRAW_SHARE_DECIMALS = 4;
+/** CosmWasm MsgExecuteContract payload — flat shape for one msg. */
+export type RangeTransactionParams = {
+    contractAddress: string;
+    executeMsg: object;
+    funds: Coin[];
+};
+/**
+ * Multi-msg payload for atomic close (claim + withdraw 100%).
+ * Callers MUST sign + broadcast all msgs in a SINGLE cosmos tx so they are
+ * atomic. Two separate txs would leak state between claim and withdraw.
+ */
+export type RangeMultiTransactionParams = {
+    msgs: RangeTransactionParams[];
+};
+/** Parameters for a CCL range position config. */
+export type RangeConfig = {
+    /** Upper price bound (Decimal string, up to 12 fractional digits). Above this, position is 100% quote. */
+    high: string;
+    /** Lower price bound (Decimal string, 12 dp). Below this, position is 100% base. */
+    low: string;
+    /** Target profit per round trip (Decimal string, 12 dp, 0 < spread < 1). */
+    spread: string;
+    /** Distribution shape parameter (Decimal string, 12 dp, signed). Upstream UI presets use 0. */
+    skew: string;
+    /** Fraction of spread retained as claimable yield (Decimal string, 12 dp). Set equal to spread for accurate APR analytics. */
+    fee: string;
+};
+export type CreatePositionParams = {
+    pairAddress: string;
+    config: RangeConfig;
+    /** Base asset coin to deposit. Amount in smallest unit (string). */
+    base: Coin;
+    /** Quote asset coin to deposit. Amount in smallest unit (string). */
+    quote: Coin;
+};
+export type DepositParams = {
+    pairAddress: string;
+    idx: string;
+    base: Coin;
+    quote: Coin;
+};
+export type WithdrawParams = {
+    pairAddress: string;
+    idx: string;
+    /**
+     * Share of the position to withdraw, as a Decimal string with up to 4 fractional
+     * digits. 0 < share <= 1. Pass "1" for a full withdraw (but note this leaves
+     * unclaimed fees behind — use `buildWithdrawAll` for the atomic close path).
+     */
+    share: string;
+};
+export type ClaimParams = {
+    pairAddress: string;
+    idx: string;
+};
+export type TransferParams = {
+    pairAddress: string;
+    idx: string;
+    /** Destination thor1... address. Validated before building. */
+    to: string;
+};
+export type WithdrawAllParams = {
+    pairAddress: string;
+    idx: string;
+};
+/** Analytics snapshot for a range position (scaled — use constants above to divide). */
+export type RangeAnalytics = {
+    /** Multiple on Invested Capital, scaled by RANGE_MOIC_SCALE. */
+    moic?: string;
+    /** Distributed Paid-In ratio, scaled by RANGE_MOIC_SCALE. */
+    dpi?: string;
+    /** Annualized yield from claimable profits, scaled by RANGE_APR_SCALE. Only meaningful when fee > 0. */
+    apr?: string;
+    /** First deposit ISO timestamp. */
+    firstDepositDate?: string;
+};
+export type RangePosition = {
+    idx: string;
+    pairAddress: string;
+    base: string;
+    quote: string;
+    feesBase: string;
+    feesQuote: string;
+    /** Principal value in USD base units (8 dp). */
+    principalUsd?: string;
+    /** Claimable yield value in USD base units (8 dp). */
+    yieldUsd?: string;
+    config?: RangeConfig;
+    analytics?: RangeAnalytics;
+};
+export type FinPair = {
+    address: string;
+    base: {
+        symbol: string;
+        denom: string;
+    };
+    quote: {
+        symbol: string;
+        denom: string;
+    };
+};
+/**
+ * Builders + queries for RUJI Trade CCL range positions.
+ *
+ * ExecuteMsg shapes (keep in sync with `rujira-ui` Range.tsx / RangeManage.tsx):
+ *
+ * - create:   `{ range: { create:   { config: { high, low, spread, skew, fee } } } }`
+ * - deposit:  `{ range: { deposit:  { idx } } }`
+ * - withdraw: `{ range: { withdraw: { idx, amount } } }`  (amount is the share Decimal 4dp)
+ * - claim:    `{ range: { claim:    { idx } } }`
+ * - transfer: `{ range: { transfer: { idx, to } } }`
+ */
+export declare class RujiraRange {
+    private readonly client;
+    constructor(client: RujiraClient);
+    buildCreatePosition(params: CreatePositionParams): RangeTransactionParams;
+    buildDeposit(params: DepositParams): RangeTransactionParams;
+    buildWithdraw(params: WithdrawParams): RangeTransactionParams;
+    buildClaim(params: ClaimParams): RangeTransactionParams;
+    buildTransfer(params: TransferParams): RangeTransactionParams;
+    /**
+     * Atomic close: claim fees + withdraw 100%. Emits two MsgExecuteContract
+     * payloads that MUST be signed + broadcast in a single cosmos tx. The order
+     * matters — claim first, then withdraw — to guarantee fees are harvested.
+     */
+    buildWithdrawAll(params: WithdrawAllParams): RangeMultiTransactionParams;
+    /**
+     * List open range positions for a THORChain address.
+     * Returns [] when the account has no positions.
+     */
+    getPositions(owner: string): Promise<RangePosition[]>;
+    /**
+     * Fetch a single range position by (pairAddress, idx).
+     * Returns null when the position doesn't exist.
+     */
+    getPosition(pairAddress: string, idx: string): Promise<RangePosition | null>;
+    /**
+     * Resolve a FIN pair contract address from base + quote asset identifiers
+     * (denom or THORChain ticker). Returns null when the pair doesn't exist.
+     */
+    getPairAddress(base: string, quote: string): Promise<FinPair | null>;
+}
+//# sourceMappingURL=range.d.ts.map

package/dist/modules/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/modules/range.ts"],"names":[],"mappings":"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"}