@varla/sdk 1.10.4 → 1.10.6

package/README.md

@@ -209,6 +209,93 @@ import { formatUnitsSafe } from "@varla/sdk/format";
 const ids = await views.readOracleRegistry({ oracle: c.oracle, client });
 ```
 
+### Write actions (simulate-first)
+
+The SDK intentionally uses a **simulate-first** pattern:
+
+1. build a transaction request via `publicClient.simulateContract`
+2. submit it via `walletClient.writeContract`
+
+```ts
+import * as actions from "@varla/sdk/actions";
+
+const sim = await actions.prepareCoreBorrow({
+  publicClient,
+  coreAddress: c.core.address,
+  account: wallet.account.address,
+  amount: 1_000_000n,
+});
+
+const hash = await actions.sendTx({ walletClient, request: sim.request });
+```
+
+### Oracle seeding (plan → prepare → execute)
+
+The SDK provides **idempotent seeding planners** for VarlaOracle configuration.
+This is useful for both backends and UIs:
+
+- `planOracleSeed(...)` produces a “diff plan” (what still needs to be configured)
+- `prepareOracleSeedPlan(...)` converts the plan into `simulateContract` requests
+- `executeOracleSeedPlan(...)` submits the prepared requests sequentially (no retries/polling)
+
+#### Node convenience: seed from JSON files
+
+The JSON shapes mirror `scripts/examples/*.json`:
+
+```ts
+import * as actions from "@varla/sdk/actions";
+
+const seeded = await actions.seedOracleFromJsonFiles({
+  oracle: c.oracle,
+  marketsPath: "./markets.polygon.json",
+  oppositesPath: "./opposites.polygon.json",
+  negRiskPath: "./negrisk.polygon.json",
+  prepare: {
+    publicClient,
+    oracleAddress: c.oracle.address,
+    account: wallet.account.address,
+  },
+});
+
+// Inspect the plan before sending txs.
+console.log(seeded.plan);
+
+if ("prepared" in seeded) {
+  const hashes = await actions.executeOracleSeedPlan({
+    walletClient,
+    prepared: seeded.prepared,
+  });
+  console.log(hashes);
+}
+```
+
+#### Browser/backend: seed from already-parsed JSON
+
+```ts
+const seeded = await actions.seedOracleFromJson({
+  oracle: c.oracle,
+  marketsJson,
+  oppositesJson,
+  negRiskJson,
+});
+```
+
+### RBAC preflight (AccessManager)
+
+The protocol uses an `AccessManager` for RBAC.
+
+```ts
+import * as actions from "@varla/sdk/actions";
+
+const selector = actions.selectorFromSignature(actions.ORACLE_SIGS.configurePositionsBatch);
+await actions.assertCanCallImmediate({
+  accessManager: c.accessManager,
+  caller: wallet.account.address,
+  target: c.oracle.address,
+  selector,
+});
+```
+
 #### Optional deployments
 
 Some deployments are chain-specific (e.g. adapters). These are exposed as optional properties:

package/dist/actions/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./tx.js";
+export * from "./utils.js";
 export * from "./oracle.js";
 export * from "./core.js";
 export * from "./erc20.js";

package/dist/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/actions/index.js

@@ -1,5 +1,6 @@
 // Note: explicit .js extension is required for Node ESM resolution.
 export * from "./tx.js";
+export * from "./utils.js";
 export * from "./oracle.js";
 export * from "./core.js";
 export * from "./erc20.js";

package/dist/actions/oracle.d.ts

@@ -1,4 +1,5 @@
 import type { Address, PublicClient } from "viem";
+import type { Hash, WalletClient } from "viem";
 export type SimulatedTx = Awaited<ReturnType<PublicClient["simulateContract"]>>;
 export type MarketConfigItem = {
     positionId: bigint;
@@ -38,4 +39,130 @@ export declare function prepareOracleUpdatePrices(params: {
     account: Address;
     items: readonly OraclePriceUpdateItem[];
 }): Promise<SimulatedTx>;
+export type OracleLikeForSeeding = {
+    address: Address;
+    read: {
+        isConfigured: (args: readonly [bigint]) => Promise<boolean>;
+        getOppositePositionId: (args: readonly [bigint]) => Promise<bigint>;
+        isNegRisk: (args: readonly [bigint]) => Promise<boolean>;
+        getNegRiskMarketId: (args: readonly [bigint]) => Promise<`0x${string}`>;
+    };
+};
+export type OracleSeedPlan = {
+    /** New positions to configure via configurePositionsBatch */
+    configurePositions: MarketConfigItem[];
+    /** Opposite pairs to configure (skips already-correct pairs) */
+    configureOpposites: Array<{
+        yesPositionId: bigint;
+        noPositionId: bigint;
+    }>;
+    /** NegRisk mapping updates (only positionIds that are missing or mismatched) */
+    configureNegRisk: Array<{
+        marketId: `0x${string}`;
+        positionIds: bigint[];
+    }>;
+};
+export declare function planOracleSeed(params: {
+    oracle: OracleLikeForSeeding;
+    markets?: ReadonlyArray<MarketConfigItem>;
+    opposites?: ReadonlyArray<{
+        yesPositionId: bigint;
+        noPositionId: bigint;
+    }>;
+    negRisk?: ReadonlyArray<{
+        marketId: `0x${string}`;
+        positionIds: ReadonlyArray<bigint>;
+    }>;
+}): Promise<OracleSeedPlan>;
+export type OracleSeedExecResult = {
+    plan: OracleSeedPlan;
+    simulations: {
+        configurePositions?: SimulatedTx;
+        configureOpposites: SimulatedTx[];
+        configureNegRisk: SimulatedTx[];
+    };
+};
+export type MarketConfigItemJson = {
+    positionId: string | number;
+    riskTier: number;
+    conditionId: `0x${string}`;
+    resolutionTime: string | number;
+};
+export type OppositePairItemJson = {
+    yesPositionId: string | number;
+    noPositionId: string | number;
+};
+export type NegRiskMarketItemJson = {
+    marketId: `0x${string}`;
+    positionIds: Array<string | number>;
+};
+/**
+ * High-level helper for backends/frontends: seed using already-parsed JSON.
+ *
+ * This is environment-agnostic (browser-safe).
+ */
+export type SeedOracleFromJsonResult = {
+    plan: OracleSeedPlan;
+} | {
+    plan: OracleSeedPlan;
+    prepared: OracleSeedExecResult;
+};
+export declare function seedOracleFromJson(params: {
+    oracle: OracleLikeForSeeding;
+    marketsJson?: readonly MarketConfigItemJson[];
+    oppositesJson?: readonly OppositePairItemJson[];
+    negRiskJson?: readonly NegRiskMarketItemJson[];
+    /**
+     * Optional: if provided, also prepares simulateContract requests.
+     * If omitted, only returns the diff plan.
+     */
+    prepare?: {
+        publicClient: Pick<PublicClient, "simulateContract">;
+        oracleAddress: Address;
+        account: Address;
+    };
+}): Promise<SeedOracleFromJsonResult>;
+/**
+ * Node-only convenience helper: read JSON files from disk and seed.
+ *
+ * This uses dynamic imports so bundlers don’t pull `node:fs` into frontend builds.
+ */
+export declare function seedOracleFromJsonFiles(params: {
+    oracle: OracleLikeForSeeding;
+    marketsPath?: string;
+    oppositesPath?: string;
+    negRiskPath?: string;
+    prepare?: {
+        publicClient: Pick<PublicClient, "simulateContract">;
+        oracleAddress: Address;
+        account: Address;
+    };
+}): Promise<SeedOracleFromJsonResult>;
+/**
+ * Given a plan (usually from `planOracleSeed`), prepare all necessary tx requests via simulate.
+ *
+ * NOTE: This does not send txs; use `sendTx({ walletClient, request: sim.request })`.
+ */
+export declare function prepareOracleSeedPlan(params: {
+    publicClient: Pick<PublicClient, "simulateContract">;
+    oracleAddress: Address;
+    account: Address;
+    plan: OracleSeedPlan;
+}): Promise<OracleSeedExecResult>;
+/**
+ * Execute a prepared oracle seed plan by sending the simulated requests in a safe order.
+ *
+ * This is intentionally minimal:
+ * - sequential
+ * - no retries
+ * - no receipt waiting/polling
+ */
+export declare function executeOracleSeedPlan(params: {
+    walletClient: Pick<WalletClient, "writeContract">;
+    prepared: OracleSeedExecResult;
+}): Promise<{
+    configurePositions?: Hash;
+    configureOpposites: Hash[];
+    configureNegRisk: Hash[];
+}>;
 //# sourceMappingURL=oracle.d.ts.map

package/dist/actions/oracle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/actions/oracle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIlD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAsB,oCAAoC,CAAC,MAAM,EAAE;IACjE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IACrD,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpC,GAAG,OAAO,CAAC,WAAW,CAAC,CAavB;AAED,wBAAsB,uCAAuC,CAAC,MAAM,EAAE;IACpE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IACrD,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,WAAW,CAAC,CAQvB;AAED,wBAAsB,2CAA2C,CAAC,MAAM,EAAE;IACxE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IACrD,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;CACzB,GAAG,OAAO,CAAC,WAAW,CAAC,CAQvB;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IACrD,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACzC,GAAG,OAAO,CAAC,WAAW,CAAC,CAavB"}
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/actions/oracle.ts"],"names":[],"mappings":"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"}

package/dist/actions/oracle.js

@@ -1,5 +1,6 @@
 // Note: explicit .js extension is required for Node ESM resolution.
 import { abis } from "../generated.js";
+import { sendTx } from "./tx.js";
 export async function prepareOracleConfigurePositionsBatch(params) {
     const positionIds = params.items.map((x) => x.positionId);
     const riskTiers = params.items.map((x) => x.riskTier);
@@ -44,3 +45,216 @@ export async function prepareOracleUpdatePrices(params) {
         account: params.account,
     }));
 }
+export async function planOracleSeed(params) {
+    const plan = {
+        configurePositions: [],
+        configureOpposites: [],
+        configureNegRisk: [],
+    };
+    // ---------------------
+    // markets (configure)
+    // ---------------------
+    if (params.markets && params.markets.length > 0) {
+        // Idempotent: only configure markets not already configured.
+        for (const it of params.markets) {
+            const ok = await params.oracle.read.isConfigured([it.positionId]);
+            if (!ok)
+                plan.configurePositions.push({ ...it });
+        }
+    }
+    // ---------------------
+    // opposites
+    // ---------------------
+    if (params.opposites && params.opposites.length > 0) {
+        for (const p of params.opposites) {
+            const curYes = await params.oracle.read.getOppositePositionId([p.yesPositionId]);
+            const curNo = await params.oracle.read.getOppositePositionId([p.noPositionId]);
+            if (curYes === p.noPositionId && curNo === p.yesPositionId)
+                continue;
+            plan.configureOpposites.push({
+                yesPositionId: p.yesPositionId,
+                noPositionId: p.noPositionId,
+            });
+        }
+    }
+    // ---------------------
+    // negRisk
+    // ---------------------
+    if (params.negRisk && params.negRisk.length > 0) {
+        for (const m of params.negRisk) {
+            const missing = [];
+            for (const pid of m.positionIds) {
+                const isNeg = await params.oracle.read.isNegRisk([pid]);
+                if (!isNeg) {
+                    missing.push(pid);
+                    continue;
+                }
+                const curMarketId = await params.oracle.read.getNegRiskMarketId([pid]);
+                if (curMarketId.toLowerCase() !== m.marketId.toLowerCase()) {
+                    missing.push(pid);
+                }
+            }
+            if (missing.length > 0) {
+                plan.configureNegRisk.push({ marketId: m.marketId, positionIds: missing });
+            }
+        }
+    }
+    return plan;
+}
+function toBigIntU256(x) {
+    if (typeof x === "number")
+        return BigInt(x);
+    if (x.startsWith("0x"))
+        return BigInt(x);
+    return BigInt(x);
+}
+function normalizeMarketsJson(items) {
+    return items.map((it) => ({
+        positionId: toBigIntU256(it.positionId),
+        riskTier: it.riskTier,
+        conditionId: it.conditionId,
+        resolutionTime: toBigIntU256(it.resolutionTime),
+    }));
+}
+function normalizeOppositesJson(items) {
+    return items.map((it) => ({
+        yesPositionId: toBigIntU256(it.yesPositionId),
+        noPositionId: toBigIntU256(it.noPositionId),
+    }));
+}
+function normalizeNegRiskJson(items) {
+    return items.map((it) => ({
+        marketId: it.marketId,
+        positionIds: it.positionIds.map(toBigIntU256),
+    }));
+}
+export async function seedOracleFromJson(params) {
+    const markets = params.marketsJson ? normalizeMarketsJson(params.marketsJson) : undefined;
+    const opposites = params.oppositesJson ? normalizeOppositesJson(params.oppositesJson) : undefined;
+    const negRisk = params.negRiskJson ? normalizeNegRiskJson(params.negRiskJson) : undefined;
+    const plan = await planOracleSeed({ oracle: params.oracle, markets, opposites, negRisk });
+    if (!params.prepare)
+        return { plan };
+    const prepared = await prepareOracleSeedPlan({
+        publicClient: params.prepare.publicClient,
+        oracleAddress: params.prepare.oracleAddress,
+        account: params.prepare.account,
+        plan,
+    });
+    return { plan, prepared };
+}
+/**
+ * Node-only convenience helper: read JSON files from disk and seed.
+ *
+ * This uses dynamic imports so bundlers don’t pull `node:fs` into frontend builds.
+ */
+export async function seedOracleFromJsonFiles(params) {
+    let readFileSync;
+    try {
+        // Node 18+/Bun supports `node:fs`.
+        ({ readFileSync } = (await import("node:fs")));
+    }
+    catch {
+        throw new Error("seedOracleFromJsonFiles() is Node-only. In browsers, load JSON via fetch and call seedOracleFromJson().");
+    }
+    if (!readFileSync) {
+        throw new Error("Failed to load node:fs readFileSync");
+    }
+    const marketsJson = params.marketsPath
+        ? JSON.parse(readFileSync(params.marketsPath, "utf8"))
+        : undefined;
+    const oppositesJson = params.oppositesPath
+        ? JSON.parse(readFileSync(params.oppositesPath, "utf8"))
+        : undefined;
+    const negRiskJson = params.negRiskPath
+        ? JSON.parse(readFileSync(params.negRiskPath, "utf8"))
+        : undefined;
+    return seedOracleFromJson({
+        oracle: params.oracle,
+        marketsJson,
+        oppositesJson,
+        negRiskJson,
+        prepare: params.prepare,
+    });
+}
+/**
+ * Given a plan (usually from `planOracleSeed`), prepare all necessary tx requests via simulate.
+ *
+ * NOTE: This does not send txs; use `sendTx({ walletClient, request: sim.request })`.
+ */
+export async function prepareOracleSeedPlan(params) {
+    const { plan } = params;
+    const configurePositions = plan.configurePositions.length > 0
+        ? await prepareOracleConfigurePositionsBatch({
+            publicClient: params.publicClient,
+            oracleAddress: params.oracleAddress,
+            account: params.account,
+            items: plan.configurePositions,
+        })
+        : undefined;
+    const configureOpposites = [];
+    for (const p of plan.configureOpposites) {
+        configureOpposites.push(await prepareOracleConfigureOppositePositions({
+            publicClient: params.publicClient,
+            oracleAddress: params.oracleAddress,
+            account: params.account,
+            yesPositionId: p.yesPositionId,
+            noPositionId: p.noPositionId,
+        }));
+    }
+    const configureNegRisk = [];
+    for (const m of plan.configureNegRisk) {
+        // Avoid useless batch calls.
+        if (m.positionIds.length === 0)
+            continue;
+        configureNegRisk.push(await prepareOracleConfigureNegRiskPositionsBatch({
+            publicClient: params.publicClient,
+            oracleAddress: params.oracleAddress,
+            account: params.account,
+            positionIds: m.positionIds,
+            marketId: m.marketId,
+        }));
+    }
+    return {
+        plan,
+        simulations: {
+            configurePositions,
+            configureOpposites,
+            configureNegRisk,
+        },
+    };
+}
+/**
+ * Execute a prepared oracle seed plan by sending the simulated requests in a safe order.
+ *
+ * This is intentionally minimal:
+ * - sequential
+ * - no retries
+ * - no receipt waiting/polling
+ */
+export async function executeOracleSeedPlan(params) {
+    const out = {
+        configureOpposites: [],
+        configureNegRisk: [],
+    };
+    const sims = params.prepared.simulations;
+    if (sims.configurePositions) {
+        out.configurePositions = await sendTx({
+            walletClient: params.walletClient,
+            request: sims.configurePositions.request,
+        });
+    }
+    for (const sim of sims.configureOpposites) {
+        out.configureOpposites.push(await sendTx({
+            walletClient: params.walletClient,
+            request: sim.request,
+        }));
+    }
+    for (const sim of sims.configureNegRisk) {
+        out.configureNegRisk.push(await sendTx({
+            walletClient: params.walletClient,
+            request: sim.request,
+        }));
+    }
+    return out;
+}

package/dist/actions/rbac.d.ts

@@ -1,4 +1,15 @@
 import type { Address, Hex } from "viem";
+/**
+ * ABI signatures for commonly preflighted RBAC targets.
+ *
+ * Use with `selectorFromSignature(sig)`.
+ */
+export declare const ORACLE_SIGS: {
+    readonly configurePositionsBatch: "configurePositionsBatch(uint256[],uint8[],bytes32[],uint256[])";
+    readonly configureOppositePositions: "configureOppositePositions(uint256,uint256)";
+    readonly configureNegRiskPositionsBatch: "configureNegRiskPositionsBatch(uint256[],bytes32)";
+    readonly updatePrices: "updatePrices(uint256[],uint256[],uint256[],uint256[])";
+};
 /**
  * Minimal AccessManager interface needed for RBAC preflight.
  */

package/dist/actions/rbac.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rbac.d.ts","sourceRoot":"","sources":["../../src/actions/rbac.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE;QACJ,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACvE,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAGF,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,aAAa,EAAE,wBAAwB,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC;CACf,GAAG,OAAO,CAAC,aAAa,CAAC,CAezB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,aAAa,EAAE,wBAAwB,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}
+{"version":3,"file":"rbac.d.ts","sourceRoot":"","sources":["../../src/actions/rbac.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAMzC;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;CAMd,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE;QACJ,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACvE,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAGF,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,aAAa,EAAE,wBAAwB,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC;CACf,GAAG,OAAO,CAAC,aAAa,CAAC,CAezB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,aAAa,EAAE,wBAAwB,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}

package/dist/actions/rbac.js

@@ -1,4 +1,18 @@
 // Note: explicit .js extension is required for Node ESM resolution.
+// ---------------------------------------------------------------------------
+// Common signatures (DevEx)
+// ---------------------------------------------------------------------------
+/**
+ * ABI signatures for commonly preflighted RBAC targets.
+ *
+ * Use with `selectorFromSignature(sig)`.
+ */
+export const ORACLE_SIGS = {
+    configurePositionsBatch: "configurePositionsBatch(uint256[],uint8[],bytes32[],uint256[])",
+    configureOppositePositions: "configureOppositePositions(uint256,uint256)",
+    configureNegRiskPositionsBatch: "configureNegRiskPositionsBatch(uint256[],bytes32)",
+    updatePrices: "updatePrices(uint256[],uint256[],uint256[],uint256[])",
+};
 // wraps: AccessManager.canCall
 export async function readCanCall(params) {
     const raw = await params.accessManager.read.canCall([

package/dist/actions/utils.d.ts

@@ -0,0 +1,9 @@
+import type { Hex } from "viem";
+/**
+ * Compute a 4-byte function selector from a Solidity function signature.
+ *
+ * Example:
+ * - "borrow(uint256)" -> 0x....
+ */
+export declare function selectorFromSignature(signature: string): Hex;
+//# sourceMappingURL=utils.d.ts.map

package/dist/actions/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/actions/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAGhC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAG5D"}

package/dist/actions/utils.js

@@ -0,0 +1,12 @@
+// Note: explicit .js extension is required for Node ESM resolution.
+import { keccak256, toBytes } from "viem";
+/**
+ * Compute a 4-byte function selector from a Solidity function signature.
+ *
+ * Example:
+ * - "borrow(uint256)" -> 0x....
+ */
+export function selectorFromSignature(signature) {
+    const hash = keccak256(toBytes(signature));
+    return `0x${hash.slice(2, 10)}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@varla/sdk",
-  "version": "1.10.4",
+  "version": "1.10.6",
   "private": false,
   "type": "module",
   "sideEffects": false,