@varla/sdk 2.10.0 → 2.11.0

package/AGENTS.md

@@ -21,6 +21,7 @@ Published package: **@varla/sdk**
 - Errors: `@varla/sdk/errors`
 - Utilities: `@varla/sdk/batch`, `@varla/sdk/format`
 - Leverage: `@varla/sdk/leverage`
+- Safe/proxy wallet: `@varla/sdk/safe`
 
 ---
 
@@ -89,6 +90,55 @@ if (decoded) console.log(formatVarlaError(decoded));
 
 ---
 
+## Proxy wallet / Safe integration (`@varla/sdk/safe`)
+
+Polymarket users hold ERC-1155 positions inside Gnosis Safe proxy wallets.
+The `@varla/sdk/safe` subpath encodes multiple SDK `prepare*()` results into a single
+Safe MultiSend transaction — enabling atomic approve → deposit → borrow flows.
+
+### Why no contract changes are needed
+
+VarlaCore's `deposit()`, `borrow()`, etc. accept any `msg.sender`. When a Gnosis Safe
+calls VarlaCore, positions and debt are tracked under the Safe's address.
+
+### Key functions
+
+- `encodeSafeMultiSend(inputs, options?)` — Encodes an array of txs into Safe MultiSend format.
+  Accepts both raw `{ to, data, value }` and `prepare*()` simulation results.
+  Returns `{ to, data, value, count }` ready for Safe SDK submission.
+- `encodeSafeMultiSendCallOnly(inputs)` — Same but uses the "call only" MultiSend contract.
+
+### Usage pattern
+
+```ts
+import { encodeSafeMultiSend } from "@varla/sdk/safe";
+import * as actions from "@varla/sdk/actions";
+
+// Always use the Safe address as `account` in prepare*() calls
+const approve = await actions.prepareErc1155SetApprovalForAll({
+  publicClient, tokenAddress: ctfAddress, account: safeAddress,
+  operator: coreAddress, approved: true,
+});
+const deposit = await actions.prepareCoreDeposit({
+  publicClient, coreAddress, account: safeAddress,
+  positionIds: [posId], amounts: [amt],
+});
+const borrow = await actions.prepareCoreBorrow({
+  publicClient, coreAddress, account: safeAddress, amount: borrowAmt,
+});
+
+const batch = encodeSafeMultiSend([approve, deposit, borrow]);
+// Submit via Safe SDK with operation: 1 (DELEGATECALL to MultiSend)
+```
+
+### Important notes
+
+- **Single-tx optimization**: When given 1 input, returns it directly (no MultiSend wrapper).
+- **`account` must be the Safe address**: Contracts track state under `msg.sender`, which is the Safe.
+- **Constants**: `SAFE_MULTISEND_ADDRESS` (`0x3886…`) and `SAFE_MULTISEND_CALL_ONLY_ADDRESS` (`0x9641…`) are exported — same addresses on all EVM chains.
+
+---
+
 ## Not provided by the SDK (by design)
 
 - **"Interest accrued / lender earnings" for a user**
@@ -112,16 +162,16 @@ if (decoded) console.log(formatVarlaError(decoded));
 <!-- BEGIN GENERATED:EXPORTS -->
 <!--
   Auto-generated by scripts/sdk/generate-docs.ts — DO NOT EDIT MANUALLY.
-  364 functions, 181 types across 10 subpaths.
+  368 functions, 189 types across 11 subpaths.
 -->
 
-### `@varla/sdk` (180 functions, 92 types, 8 constants)
+### `@varla/sdk` (182 functions, 96 types, 10 constants)
 
-**Functions:** `prepareCoreSetDefaultLtvConfig`, `prepareCoreSetLiquidationConfig`, `prepareCoreSetTierLiquidationConfig`, `prepareCoreSetMaxPositions`, `prepareCoreSetMaxPositionsBounds`, `prepareCoreSetOracle`, `prepareCoreSetPositionLtvOverride`, `prepareCoreClearPositionLtvOverride`, `prepareCoreSetPositionLiquidationConfigOverride`, `prepareCoreClearPositionLiquidationConfigOverride`, `preparePoolSetDepositCap`, `preparePoolSetBorrowCap`, `preparePoolWithdrawReserve`, `preparePoolSetInterestRateStrategy`, `prepareOracleSetMaxStaleness`, `prepareOracleSetLiquidationGracePeriod`, `prepareOracleSetDefaultEarlyClosureWindow`, `prepareStrategySetPool`, `prepareStrategySetRateParams`, `prepareOracleUpdaterRouterSetPublisher`, `prepareCoreDeposit`, `prepareCoreWithdraw`, `prepareCoreBorrow`, `prepareCoreRepay`, `prepareErc20Approve`, `prepareErc1155SetApprovalForAll`, `prepareLiquidatorLiquidate`, `prepareLiquidatorLiquidateMulti`, `prepareLiquidatorLiquidateBadDebt`, `prepareLiquidatorResolveBadDebtWithReserve`, `prepareOracleConfigurePositionsBatch`, `prepareOracleConfigurePosition`, `prepareOracleSetUpdater`, `prepareOracleSetPositionEarlyClosureWindowOverride`, `prepareOracleClearPositionEarlyClosureWindowOverride`, `prepareOracleInvalidatePosition`, `prepareOracleValidatePosition`, `prepareOracleRegisterNegRiskMarketPositions`, `prepareOracleOverrideNegRiskMarketPositions`, `prepareOracleConfigureOppositePositions`, `prepareOracleConfigureOppositePositionsBatch`, `prepareOracleConfigureNegRiskPositionsBatch`, `prepareOracleUpdatePrices`, `prepareOracleUpdatePrice`, `prepareOracleFinalizePosition`, `prepareOracleUnfinalizePosition`, `prepareOracleResolvePositionEarly`, `prepareOracleBatchFinalizePositions`, `prepareOracleBatchResolvePositionsEarly`, `prepareOracleSetResolutionPrice`, `planOracleSeed`, `seedOracleFromJson`, `seedOracleFromJsonFiles`, `prepareOracleSeedPlan`, `executeOracleSeedPlan`, `buildNonce`, `splitNonce`, `readOracleUpdaterRouterLaneSeq`, `readOracleUpdaterRouterNonce`, `toOracleUpdaterRouterTypedMessage`, `computeOracleUpdaterDigest`, `signOracleUpdaterRouterUpdate`, `prepareOracleUpdaterRouterUpdatePricesWithSig`, `preparePoolDeposit`, `preparePoolMint`, `preparePoolWithdraw`, `preparePoolRedeem`, `readCanCall`, `assertCanCallImmediate`, `sendTx`, `selectorFromSignature`, `chunk`, `multicallChunks`, `getAddressBook`, `getVarlaContracts`, `getRequiredVarlaContracts`, `getErc20`, `getErc1155`, `getErc4626`, `decodeEventLogs`, `getEventLogsChunked`, `syncOracleRegistryViaEvents`, `getRecentEvents`, `formatWad`, `formatBps`, `formatPriceE8`, `parseUnits`, `parseWad`, `isSupportedChain`, `assertSupportedChain`, `getChainMeta`, `readAccessManagerBasics`, `readRoleSummary`, `readTargetConfig`, `readHasRole`, `readManyHasRole`, `readManyTargetFunctionRoles`, `readManyTargetConfigs`, `readAdapterInfo`, `readInterestRateStrategyBasics`, `getInterestRateStrategyFromPool`, `readProxyAdminPaused`, `previewCoreDeposit`, `readRepayTiming`, `readPositionCount`, `readOracleGuardsStatus`, `readAccountSnapshot`, `readCoreAddresses`, `readMaxPositionsConfig`, `readAccountPositionsFull`, `readPositionBalances`, `readBorrowerState`, `readPortfolioValue`, `readBorrowers`, `readCoreGlobalDebt`, `readPositionLiquidationConfigOverride`, `readPositionBalance`, `readAccountPositions`, `readBorrowersPage`, `readManyAccountSnapshots`, `readHealthFactor`, `readLiquidationConfig`, `readDefaultLtvConfig`, `readTieredLtvConfig`, `readTierLiquidationConfig`, `readLiquidationParamsForPosition`, `readPositionLtvOverride`, `readLtvForPosition`, `readLiquidationBonusBps`, `readManyLiquidationBonusBps`, `readWalletPositionIds`, `previewBorrow`, `previewRepay`, `readBorrowLimits`, `readManyBorrowLimits`, `readHypotheticalBorrowCapacity`, `computeLiquidationPrice`, `readLiquidationPrice`, `readLenderSnapshot`, `readMaxWithdraw`, `readMaxRedeem`, `readLiquidatorBasics`, `readCanLiquidate`, `readPreviewLiquidation`, `readCalculateLiquidationBonus`, `readBadDebtStatus`, `readMergeLiquidatorBasics`, `readConvertLiquidatorBasics`, `rankPositionsForLiquidation`, `readLiquidationCandidates`, `readOracleRegistry`, `readOracleRegistryPage`, `readOracleFinalizationStatus`, `readOracleConfig`, `readOracleCollateralStatus`, `readTryGetPrice`, `readOraclePriceData`, `readOracleBasics`, `readOracleTiming`, `readConfiguredPositionIds`, `readNegRiskMarketPositionIds`, `readRiskTier`, `readSpotPrice`, `readTwap`, `readPrice`, `readLiquidity`, `readPositionSnapshot`, `readManyPositionSnapshots`, `readOraclePositionMeta`, `readManyOraclePositionMeta`, `hydrateOraclePositionIds`, `readPoolSnapshot`, `readPoolCaps`, `readPoolAccounting`, `readPoolRates`, `readPoolSharePrice`, `readPoolHealthScore`, `readPoolDebtState`, `readPoolCoreAddress`, `readSystemSnapshot`
+**Functions:** `prepareCoreSetDefaultLtvConfig`, `prepareCoreSetLiquidationConfig`, `prepareCoreSetTierLiquidationConfig`, `prepareCoreSetMaxPositions`, `prepareCoreSetMaxPositionsBounds`, `prepareCoreSetOracle`, `prepareCoreSetPositionLtvOverride`, `prepareCoreClearPositionLtvOverride`, `prepareCoreSetPositionLiquidationConfigOverride`, `prepareCoreClearPositionLiquidationConfigOverride`, `preparePoolSetDepositCap`, `preparePoolSetBorrowCap`, `preparePoolWithdrawReserve`, `preparePoolSetInterestRateStrategy`, `prepareOracleSetMaxStaleness`, `prepareOracleSetLiquidationGracePeriod`, `prepareOracleSetDefaultEarlyClosureWindow`, `prepareStrategySetPool`, `prepareStrategySetRateParams`, `prepareOracleUpdaterRouterSetPublisher`, `prepareCoreDeposit`, `prepareCoreWithdraw`, `prepareCoreBorrow`, `prepareCoreRepay`, `prepareErc20Approve`, `prepareErc1155SetApprovalForAll`, `prepareLiquidatorLiquidate`, `prepareLiquidatorLiquidateMulti`, `prepareLiquidatorLiquidateBadDebt`, `prepareLiquidatorResolveBadDebtWithReserve`, `prepareOracleConfigurePositionsBatch`, `prepareOracleConfigurePosition`, `prepareOracleSetUpdater`, `prepareOracleSetPositionEarlyClosureWindowOverride`, `prepareOracleClearPositionEarlyClosureWindowOverride`, `prepareOracleInvalidatePosition`, `prepareOracleValidatePosition`, `prepareOracleRegisterNegRiskMarketPositions`, `prepareOracleOverrideNegRiskMarketPositions`, `prepareOracleConfigureOppositePositions`, `prepareOracleConfigureOppositePositionsBatch`, `prepareOracleConfigureNegRiskPositionsBatch`, `prepareOracleUpdatePrices`, `prepareOracleUpdatePrice`, `prepareOracleFinalizePosition`, `prepareOracleUnfinalizePosition`, `prepareOracleResolvePositionEarly`, `prepareOracleBatchFinalizePositions`, `prepareOracleBatchResolvePositionsEarly`, `prepareOracleSetResolutionPrice`, `planOracleSeed`, `seedOracleFromJson`, `seedOracleFromJsonFiles`, `prepareOracleSeedPlan`, `executeOracleSeedPlan`, `buildNonce`, `splitNonce`, `readOracleUpdaterRouterLaneSeq`, `readOracleUpdaterRouterNonce`, `toOracleUpdaterRouterTypedMessage`, `computeOracleUpdaterDigest`, `signOracleUpdaterRouterUpdate`, `prepareOracleUpdaterRouterUpdatePricesWithSig`, `preparePoolDeposit`, `preparePoolMint`, `preparePoolWithdraw`, `preparePoolRedeem`, `readCanCall`, `assertCanCallImmediate`, `sendTx`, `selectorFromSignature`, `chunk`, `multicallChunks`, `getAddressBook`, `getVarlaContracts`, `getRequiredVarlaContracts`, `getErc20`, `getErc1155`, `getErc4626`, `decodeEventLogs`, `getEventLogsChunked`, `syncOracleRegistryViaEvents`, `getRecentEvents`, `formatWad`, `formatBps`, `formatPriceE8`, `parseUnits`, `parseWad`, `isSupportedChain`, `assertSupportedChain`, `getChainMeta`, `encodeSafeMultiSend`, `encodeSafeMultiSendCallOnly`, `readAccessManagerBasics`, `readRoleSummary`, `readTargetConfig`, `readHasRole`, `readManyHasRole`, `readManyTargetFunctionRoles`, `readManyTargetConfigs`, `readAdapterInfo`, `readInterestRateStrategyBasics`, `getInterestRateStrategyFromPool`, `readProxyAdminPaused`, `previewCoreDeposit`, `readRepayTiming`, `readPositionCount`, `readOracleGuardsStatus`, `readAccountSnapshot`, `readCoreAddresses`, `readMaxPositionsConfig`, `readAccountPositionsFull`, `readPositionBalances`, `readBorrowerState`, `readPortfolioValue`, `readBorrowers`, `readCoreGlobalDebt`, `readPositionLiquidationConfigOverride`, `readPositionBalance`, `readAccountPositions`, `readBorrowersPage`, `readManyAccountSnapshots`, `readHealthFactor`, `readLiquidationConfig`, `readDefaultLtvConfig`, `readTieredLtvConfig`, `readTierLiquidationConfig`, `readLiquidationParamsForPosition`, `readPositionLtvOverride`, `readLtvForPosition`, `readLiquidationBonusBps`, `readManyLiquidationBonusBps`, `readWalletPositionIds`, `previewBorrow`, `previewRepay`, `readBorrowLimits`, `readManyBorrowLimits`, `readHypotheticalBorrowCapacity`, `computeLiquidationPrice`, `readLiquidationPrice`, `readLenderSnapshot`, `readMaxWithdraw`, `readMaxRedeem`, `readLiquidatorBasics`, `readCanLiquidate`, `readPreviewLiquidation`, `readCalculateLiquidationBonus`, `readBadDebtStatus`, `readMergeLiquidatorBasics`, `readConvertLiquidatorBasics`, `rankPositionsForLiquidation`, `readLiquidationCandidates`, `readOracleRegistry`, `readOracleRegistryPage`, `readOracleFinalizationStatus`, `readOracleConfig`, `readOracleCollateralStatus`, `readTryGetPrice`, `readOraclePriceData`, `readOracleBasics`, `readOracleTiming`, `readConfiguredPositionIds`, `readNegRiskMarketPositionIds`, `readRiskTier`, `readSpotPrice`, `readTwap`, `readPrice`, `readLiquidity`, `readPositionSnapshot`, `readManyPositionSnapshots`, `readOraclePositionMeta`, `readManyOraclePositionMeta`, `hydrateOraclePositionIds`, `readPoolSnapshot`, `readPoolCaps`, `readPoolAccounting`, `readPoolRates`, `readPoolSharePrice`, `readPoolHealthScore`, `readPoolDebtState`, `readPoolCoreAddress`, `readSystemSnapshot`
 
-**Types:** `StrategyRateParams`, `SimulatedTx`, `MarketConfigItem`, `OraclePriceUpdateItem`, `OracleLikeForSeeding`, `OracleSeedPlan`, `OracleSeedExecResult`, `MarketConfigItemJson`, `OppositePairItemJson`, `NegRiskMarketItemJson`, `SeedOracleFromJsonResult`, `OracleUpdaterRouterUpdate`, `AccessManagerCanCallLike`, `CanCallResult`, `MulticallChunkOptions`, `ReadonlyContract`, `VarlaContracts`, `GetVarlaContractsParams`, `DecodedEvent`, `GetEventLogsChunkedParams`, `OracleRegistryEntry`, `SyncOracleRegistryViaEventsParams`, `GetRecentEventsParams`, `VarlaChainKey`, `StablecoinKind`, `CollateralMeta`, `ChainMeta`, `ChainKey`, `AddressBook`, `ReadAccessManagerBasics`, `ReadManyHasRoleResult`, `ReadManyTargetFunctionRolesResult`, `ReadManyTargetConfigsResult`, `ReadAdapterInfo`, `InterestRateParams`, `DepositBlockReason`, `PreviewCoreDepositItem`, `PreviewCoreDeposit`, `ReadAccountSnapshot`, `ReadRepayTiming`, `ReadPositionCount`, `ReadOracleGuardsStatus`, `ReadCoreAddresses`, `ReadMaxPositionsConfig`, `ReadAccountPositionsFull`, `ReadPositionBalances`, `ReadBorrowerState`, `ReadPortfolioValue`, `ReadCoreGlobalDebt`, `ReadPositionLiquidationConfigOverride`, `ReadBorrowersPage`, `ReadHealthFactor`, `ReadLiquidationConfig`, `ReadDefaultLtvConfig`, `ReadTieredLtvConfig`, `ReadTierLiquidationConfig`, `ReadLiquidationParamsForPosition`, `ReadPositionLtvOverride`, `ReadManyLiquidationBonusBpsRow`, `ReadBorrowLimits`, `ReadWalletPositionIds`, `ReadHypotheticalBorrowCapacity`, `PreviewBorrow`, `PreviewRepay`, `ComputeLiquidationPriceResult`, `ReadLiquidationPrice`, `ReadLenderSnapshot`, `ReadLiquidatorBasics`, `ReadCanLiquidate`, `ReadPreviewLiquidation`, `ReadBadDebtStatus`, `LiquidationCandidate`, `ReadLiquidationCandidates`, `ReadOracleRegistryParams`, `ReadOracleRegistryPage`, `ReadOracleConfig`, `ReadOracleFinalizationStatus`, `ReadOracleCollateralStatus`, `ReadTryGetPrice`, `ReadOraclePriceData`, `ReadOracleBasics`, `ReadOracleTiming`, `ReadPositionSnapshot`, `ReadOraclePositionMeta`, `ReadPoolSnapshot`, `ReadPoolDebtState`, `ReadPoolCaps`, `ReadPoolAccounting`, `ReadPoolRates`, `ReadPoolSharePrice`, `ReadPoolHealthScore`, `ReadSystemSnapshot`
+**Types:** `StrategyRateParams`, `SimulatedTx`, `MarketConfigItem`, `OraclePriceUpdateItem`, `OracleLikeForSeeding`, `OracleSeedPlan`, `OracleSeedExecResult`, `MarketConfigItemJson`, `OppositePairItemJson`, `NegRiskMarketItemJson`, `SeedOracleFromJsonResult`, `OracleUpdaterRouterUpdate`, `AccessManagerCanCallLike`, `CanCallResult`, `MulticallChunkOptions`, `ReadonlyContract`, `VarlaContracts`, `GetVarlaContractsParams`, `DecodedEvent`, `GetEventLogsChunkedParams`, `OracleRegistryEntry`, `SyncOracleRegistryViaEventsParams`, `GetRecentEventsParams`, `VarlaChainKey`, `StablecoinKind`, `CollateralMeta`, `ChainMeta`, `SafeOperation`, `SafeMultiSendTx`, `SafeMultiSendInput`, `SafeMultiSendResult`, `ChainKey`, `AddressBook`, `ReadAccessManagerBasics`, `ReadManyHasRoleResult`, `ReadManyTargetFunctionRolesResult`, `ReadManyTargetConfigsResult`, `ReadAdapterInfo`, `InterestRateParams`, `DepositBlockReason`, `PreviewCoreDepositItem`, `PreviewCoreDeposit`, `ReadAccountSnapshot`, `ReadRepayTiming`, `ReadPositionCount`, `ReadOracleGuardsStatus`, `ReadCoreAddresses`, `ReadMaxPositionsConfig`, `ReadAccountPositionsFull`, `ReadPositionBalances`, `ReadBorrowerState`, `ReadPortfolioValue`, `ReadCoreGlobalDebt`, `ReadPositionLiquidationConfigOverride`, `ReadBorrowersPage`, `ReadHealthFactor`, `ReadLiquidationConfig`, `ReadDefaultLtvConfig`, `ReadTieredLtvConfig`, `ReadTierLiquidationConfig`, `ReadLiquidationParamsForPosition`, `ReadPositionLtvOverride`, `ReadManyLiquidationBonusBpsRow`, `ReadBorrowLimits`, `ReadWalletPositionIds`, `ReadHypotheticalBorrowCapacity`, `PreviewBorrow`, `PreviewRepay`, `ComputeLiquidationPriceResult`, `ReadLiquidationPrice`, `ReadLenderSnapshot`, `ReadLiquidatorBasics`, `ReadCanLiquidate`, `ReadPreviewLiquidation`, `ReadBadDebtStatus`, `LiquidationCandidate`, `ReadLiquidationCandidates`, `ReadOracleRegistryParams`, `ReadOracleRegistryPage`, `ReadOracleConfig`, `ReadOracleFinalizationStatus`, `ReadOracleCollateralStatus`, `ReadTryGetPrice`, `ReadOraclePriceData`, `ReadOracleBasics`, `ReadOracleTiming`, `ReadPositionSnapshot`, `ReadOraclePositionMeta`, `ReadPoolSnapshot`, `ReadPoolDebtState`, `ReadPoolCaps`, `ReadPoolAccounting`, `ReadPoolRates`, `ReadPoolSharePrice`, `ReadPoolHealthScore`, `ReadSystemSnapshot`
 
-**Constants:** `ORACLE_UPDATER_ROUTER_EIP712`, `ORACLE_UPDATER_ROUTER_TYPES`, `UPDATE_TYPEHASH`, `ORACLE_SIGS`, `ORACLE_EVENTS`, `CORE_EVENTS`, `POOL_EVENTS`, `SUPPORTED_CHAINS`
+**Constants:** `ORACLE_UPDATER_ROUTER_EIP712`, `ORACLE_UPDATER_ROUTER_TYPES`, `UPDATE_TYPEHASH`, `ORACLE_SIGS`, `ORACLE_EVENTS`, `CORE_EVENTS`, `POOL_EVENTS`, `SUPPORTED_CHAINS`, `SAFE_MULTISEND_ADDRESS`, `SAFE_MULTISEND_CALL_ONLY_ADDRESS`
 
 ### `@varla/sdk/contracts` (6 functions, 3 types)
 
@@ -174,4 +224,12 @@ if (decoded) console.log(formatVarlaError(decoded));
 **Functions:** `extractRevertData`, `decodeVarlaError`, `isVarlaError`, `formatVarlaError`, `tryFormatVarlaError`, `getAllVarlaErrorNames`, `getVarlaErrorSelectors`
 
 **Types:** `DecodedVarlaError`
+
+### `@varla/sdk/safe` (2 functions, 4 types, 2 constants)
+
+**Functions:** `encodeSafeMultiSend`, `encodeSafeMultiSendCallOnly`
+
+**Types:** `SafeOperation`, `SafeMultiSendTx`, `SafeMultiSendInput`, `SafeMultiSendResult`
+
+**Constants:** `SAFE_MULTISEND_ADDRESS`, `SAFE_MULTISEND_CALL_ONLY_ADDRESS`
 <!-- END GENERATED:EXPORTS -->

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @varla-xyz/protocol
 
+## 2.11.0
+
+### Minor Changes
+
+- f3a722e: Add Safe MultiSend utilities and exports to build batched transactions for Gnosis Safe workflows.
+
+  - Export new Safe MultiSend module with encoder functions, types, and constants for canonical MultiSend addresses
+  - Provide helpers to encode standard and call-only MultiSend batches from prepared requests or raw transactions
+
 ## 2.10.0
 
 ### Minor Changes

package/README.md

@@ -34,6 +34,7 @@ npm i @varla/sdk
 | `@varla/sdk/errors` | Custom error decoding across all Varla contracts |
 | `@varla/sdk/leverage` | Leverage loop planning, execution, and deleverage |
 | `@varla/sdk/batch` | Multicall chunking utilities for RPC-efficient reads |
+| `@varla/sdk/safe` | Gnosis Safe MultiSend encoding for proxy wallet users |
 | `@varla/sdk/format` | Number formatting (`formatWad`, `formatBps`, `parseUnits`) |
 | `@varla/sdk/types` | Shared types (`ChainKey`, `AddressBook`) |
 
@@ -254,6 +255,78 @@ console.log(plan.steps); // ordered steps: buy → deposit → borrow → buy
 
 ---
 
+## Safe / proxy wallet integration
+
+Polymarket users hold ERC-1155 positions inside Gnosis Safe proxy wallets. The `@varla/sdk/safe` subpath provides helpers to batch multiple Varla operations into a single Safe transaction — matching the UX of competitors like Gondor.
+
+**Key insight:** Varla contracts already accept calls from any `msg.sender` (EOA or Safe). No contract changes are needed. The SDK helper simply packs multiple `prepare*()` results into the Safe [MultiSend](https://github.com/safe-global/safe-smart-account/blob/main/contracts/libraries/MultiSend.sol) format.
+
+### Full example: approve → deposit → borrow in one Safe tx
+
+```ts
+import { encodeSafeMultiSend } from "@varla/sdk/safe";
+import * as actions from "@varla/sdk/actions";
+
+const safeAddress = "0x..."; // user's Gnosis Safe address
+
+// 1. Prepare each step (simulate against the Safe as msg.sender)
+const approve = await actions.prepareErc1155SetApprovalForAll({
+  publicClient: client,
+  tokenAddress: ctfAddress,
+  account: safeAddress,
+  operator: coreAddress,
+  approved: true,
+});
+
+const deposit = await actions.prepareCoreDeposit({
+  publicClient: client,
+  coreAddress: c.core.address,
+  account: safeAddress,
+  positionIds: [positionId],
+  amounts: [amount],
+});
+
+const borrow = await actions.prepareCoreBorrow({
+  publicClient: client,
+  coreAddress: c.core.address,
+  account: safeAddress,
+  amount: borrowAmount,
+});
+
+// 2. Encode as a single Safe MultiSend batch
+const batch = encodeSafeMultiSend([approve, deposit, borrow]);
+// batch.to    → Safe MultiSend contract address
+// batch.data  → encoded multiSend(bytes) calldata
+// batch.value → total ETH value (usually 0n)
+// batch.count → 3
+
+// 3. Submit via Safe SDK (or Safe Apps SDK in a dApp)
+const safeTx = await safeSdk.createTransaction({
+  transactions: [{
+    to: batch.to,
+    data: batch.data,
+    value: batch.value.toString(),
+    operation: 1, // DELEGATECALL to MultiSend
+  }],
+});
+await safeSdk.executeTransaction(safeTx);
+```
+
+### API
+
+| Function | Description |
+| --- | --- |
+| `encodeSafeMultiSend(inputs, options?)` | Encode transactions into MultiSend format. Accepts raw `{ to, data, value }` or `prepare*()` results. |
+| `encodeSafeMultiSendCallOnly(inputs)` | Same but uses the "call only" MultiSend (no DELEGATECALL in sub-txs). |
+| `SAFE_MULTISEND_ADDRESS` | Canonical MultiSend address (`0x3886…`) — same on all EVM chains. |
+| `SAFE_MULTISEND_CALL_ONLY_ADDRESS` | Canonical MultiSend "call only" address (`0x9641…`). |
+
+**Optimization:** When the batch contains a single transaction, `encodeSafeMultiSend` returns it directly without a MultiSend wrapper.
+
+**Important:** Always pass `account: safeAddress` (not the EOA signer) to `prepare*()` helpers. The contracts track positions and debt under `msg.sender`, which will be the Safe address.
+
+---
+
 ## Error decoding
 
 Automatically decode custom Solidity errors from any Varla contract.

package/dist/abi/full/VarlaOracle.d.ts

@@ -98,6 +98,22 @@ export declare const VARLAORACLE_ABI: readonly [{
     }];
     readonly name: "InvalidLiquidationGracePeriod";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint8";
+        readonly name: "tier";
+        readonly type: "uint8";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "gracePeriod";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "decayPeriod";
+        readonly type: "uint256";
+    }];
+    readonly name: "InvalidLowLiquidityConfig";
+    readonly type: "error";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "uint256";
@@ -249,6 +265,56 @@ export declare const VARLAORACLE_ABI: readonly [{
     }];
     readonly name: "LiquidationGracePeriodUpdated";
     readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "uint8";
+        readonly name: "tier";
+        readonly type: "uint8";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "oldGracePeriod";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "oldDecayPeriod";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "newGracePeriod";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "newDecayPeriod";
+        readonly type: "uint256";
+    }];
+    readonly name: "LowLiquidityConfigUpdated";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "uint256";
+        readonly name: "positionId";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "oldLowLiquiditySince";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "newLowLiquiditySince";
+        readonly type: "uint256";
+    }];
+    readonly name: "LowLiquiditySinceUpdated";
+    readonly type: "event";
 }, {
     readonly anonymous: false;
     readonly inputs: readonly [{
@@ -549,6 +615,26 @@ export declare const VARLAORACLE_ABI: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "MAX_LOW_LIQUIDITY_DECAY_PERIOD";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "MAX_LOW_LIQUIDITY_GRACE_PERIOD";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [];
     readonly name: "MAX_MAX_STALENESS";
@@ -893,6 +979,34 @@ export declare const VARLAORACLE_ABI: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "positionId";
+        readonly type: "uint256";
+    }];
+    readonly name: "getLowLiquidityFactor";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "positionId";
+        readonly type: "uint256";
+    }];
+    readonly name: "getLowLiquiditySince";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "uint256";
@@ -960,7 +1074,7 @@ export declare const VARLAORACLE_ABI: readonly [{
         readonly type: "uint8";
     }, {
         readonly internalType: "uint256";
-        readonly name: "earlyClosureFactorWad";
+        readonly name: "ltvAdjustmentFactorWad";
         readonly type: "uint256";
     }, {
         readonly internalType: "uint256";
@@ -1237,6 +1351,24 @@ export declare const VARLAORACLE_ABI: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly name: "lowLiquidityConfig";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "gracePeriod";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "decayPeriod";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [];
     readonly name: "maxStaleness";
@@ -1319,6 +1451,24 @@ export declare const VARLAORACLE_ABI: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint8";
+        readonly name: "tier";
+        readonly type: "uint8";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "gracePeriod";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "decayPeriod";
+        readonly type: "uint256";
+    }];
+    readonly name: "setLowLiquidityConfig";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "uint256";

package/dist/abi/full/VarlaOracle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VarlaOracle.d.ts","sourceRoot":"","sources":["../../../src/abi/full/VarlaOracle.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA03DJ,CAAC"}
+{"version":3,"file":"VarlaOracle.d.ts","sourceRoot":"","sources":["../../../src/abi/full/VarlaOracle.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4jEJ,CAAC"}

package/dist/abi/full/VarlaOracle.js

@@ -134,6 +134,27 @@ export const VARLAORACLE_ABI = [
         "name": "InvalidLiquidationGracePeriod",
         "type": "error"
     },
+    {
+        "inputs": [
+            {
+                "internalType": "uint8",
+                "name": "tier",
+                "type": "uint8"
+            },
+            {
+                "internalType": "uint256",
+                "name": "gracePeriod",
+                "type": "uint256"
+            },
+            {
+                "internalType": "uint256",
+                "name": "decayPeriod",
+                "type": "uint256"
+            }
+        ],
+        "name": "InvalidLowLiquidityConfig",
+        "type": "error"
+    },
     {
         "inputs": [
             {
@@ -334,6 +355,68 @@ export const VARLAORACLE_ABI = [
         "name": "LiquidationGracePeriodUpdated",
         "type": "event"
     },
+    {
+        "anonymous": false,
+        "inputs": [
+            {
+                "indexed": true,
+                "internalType": "uint8",
+                "name": "tier",
+                "type": "uint8"
+            },
+            {
+                "indexed": false,
+                "internalType": "uint256",
+                "name": "oldGracePeriod",
+                "type": "uint256"
+            },
+            {
+                "indexed": false,
+                "internalType": "uint256",
+                "name": "oldDecayPeriod",
+                "type": "uint256"
+            },
+            {
+                "indexed": false,
+                "internalType": "uint256",
+                "name": "newGracePeriod",
+                "type": "uint256"
+            },
+            {
+                "indexed": false,
+                "internalType": "uint256",
+                "name": "newDecayPeriod",
+                "type": "uint256"
+            }
+        ],
+        "name": "LowLiquidityConfigUpdated",
+        "type": "event"
+    },
+    {
+        "anonymous": false,
+        "inputs": [
+            {
+                "indexed": true,
+                "internalType": "uint256",
+                "name": "positionId",
+                "type": "uint256"
+            },
+            {
+                "indexed": false,
+                "internalType": "uint256",
+                "name": "oldLowLiquiditySince",
+                "type": "uint256"
+            },
+            {
+                "indexed": false,
+                "internalType": "uint256",
+                "name": "newLowLiquiditySince",
+                "type": "uint256"
+            }
+        ],
+        "name": "LowLiquiditySinceUpdated",
+        "type": "event"
+    },
     {
         "anonymous": false,
         "inputs": [
@@ -714,6 +797,32 @@ export const VARLAORACLE_ABI = [
         "stateMutability": "view",
         "type": "function"
     },
+    {
+        "inputs": [],
+        "name": "MAX_LOW_LIQUIDITY_DECAY_PERIOD",
+        "outputs": [
+            {
+                "internalType": "uint256",
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    },
+    {
+        "inputs": [],
+        "name": "MAX_LOW_LIQUIDITY_GRACE_PERIOD",
+        "outputs": [
+            {
+                "internalType": "uint256",
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    },
     {
         "inputs": [],
         "name": "MAX_MAX_STALENESS",
@@ -1165,6 +1274,44 @@ export const VARLAORACLE_ABI = [
         "stateMutability": "view",
         "type": "function"
     },
+    {
+        "inputs": [
+            {
+                "internalType": "uint256",
+                "name": "positionId",
+                "type": "uint256"
+            }
+        ],
+        "name": "getLowLiquidityFactor",
+        "outputs": [
+            {
+                "internalType": "uint256",
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    },
+    {
+        "inputs": [
+            {
+                "internalType": "uint256",
+                "name": "positionId",
+                "type": "uint256"
+            }
+        ],
+        "name": "getLowLiquiditySince",
+        "outputs": [
+            {
+                "internalType": "uint256",
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    },
     {
         "inputs": [
             {
@@ -1254,7 +1401,7 @@ export const VARLAORACLE_ABI = [
             },
             {
                 "internalType": "uint256",
-                "name": "earlyClosureFactorWad",
+                "name": "ltvAdjustmentFactorWad",
                 "type": "uint256"
             },
             {
@@ -1625,6 +1772,30 @@ export const VARLAORACLE_ABI = [
         "stateMutability": "view",
         "type": "function"
     },
+    {
+        "inputs": [
+            {
+                "internalType": "uint256",
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "name": "lowLiquidityConfig",
+        "outputs": [
+            {
+                "internalType": "uint256",
+                "name": "gracePeriod",
+                "type": "uint256"
+            },
+            {
+                "internalType": "uint256",
+                "name": "decayPeriod",
+                "type": "uint256"
+            }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    },
     {
         "inputs": [],
         "name": "maxStaleness",
@@ -1731,6 +1902,29 @@ export const VARLAORACLE_ABI = [
         "stateMutability": "nonpayable",
         "type": "function"
     },
+    {
+        "inputs": [
+            {
+                "internalType": "uint8",
+                "name": "tier",
+                "type": "uint8"
+            },
+            {
+                "internalType": "uint256",
+                "name": "gracePeriod",
+                "type": "uint256"
+            },
+            {
+                "internalType": "uint256",
+                "name": "decayPeriod",
+                "type": "uint256"
+            }
+        ],
+        "name": "setLowLiquidityConfig",
+        "outputs": [],
+        "stateMutability": "nonpayable",
+        "type": "function"
+    },
     {
         "inputs": [
             {