Exports & helpers

The lower-level public surface of @sail.money/sailor/sdk, grouped by purpose. Internal and experimental exports are omitted. Types are mirrored from source.

EIP-712 signing

Export	Purpose
`buildDispatchSignature`	Self-detecting `Dispatch` signer — reads the kernel’s on-chain typehash and signs the correct (selective/conjunctive) struct. Use this; don’t hand-roll.
`sailKernelDomain`	The EIP-712 domain for any `SailKernel`.
`DISPATCH_EIP712_FIELDS`	Typed struct field lists keyed by dispatch model.
`buildRegisterPermissionTypedData`	Build `RegisterPermission` typed data (accepts `hasDeadline`).
`buildRegisterPermissionsBatchTypedData`	Batch (`RegisterPermissions`) typed data.
`signRegisterPermission`	Sign a `RegisterPermission` message.
`REGISTER_PERMISSION_TYPES`, `REGISTER_PERMISSION_TYPES_NO_DEADLINE`, `REGISTER_PERMISSIONS_BATCH_TYPES`	The EIP-712 type definitions.

import { buildDispatchSignature, LocalKeyring } from "@sail.money/sailor/sdk";
import { createPublicClient, http } from "viem";

const publicClient = createPublicClient({ transport: http(rpcUrl) });
const manager = await LocalKeyring.fromKeystoreFile(".sail/keys/manager.json", passphrase);

const { signature, nonce, deadline, dispatchModel } = await buildDispatchSignature({
  publicClient, kernel, chainId: 8453,
  account: mySafe, permission: myPermission,
  call: { target: router, value: 0n, data: swapCalldata },
  manager,
});
// kernel.dispatch(account, permission, target, value, data, signature, deadline)

Kernel capability detection

Export	Purpose
`detectKernelCapabilities`	Read `DISPATCH_TYPEHASH` on-chain; identify conjunctive vs selective.
`clearCapabilityCache`	Clear the per-process capability cache.
`DispatchModel`, `KernelCapabilities`	Result types.
`DISPATCH_TYPE_STRINGS`, `DISPATCH_TYPEHASHES`, `REGISTER_PERMISSION_TYPE_STRINGS`, `REGISTER_PERMISSION_TYPEHASHES`	The known type strings/hashes per model.

Kernel errors

Export	Purpose
`decodeKernelError`	Decode a revert into a typed `KernelError`.
`explainKernelRevert`	Human-readable explanation of a kernel revert.
`KERNEL_ERROR_ABI`, `KERNEL_ERROR_SIGNATURES`	The error ABI + 4-byte signatures.

import { explainKernelRevert } from "@sail.money/sailor/sdk";
try { /* dispatch */ } catch (e) { console.error(explainKernelRevert(e)); }

Deployments & chains

Export	Purpose
`getSailDeployment(chainId)`	Resolve the kernel / factory / governance addresses for a chain.
`sailDeployments`, `normalizeDeployment`	The full registry + a normalizer.
`chains`, `getChain`	The chain registry (`ChainConfig` per chainId).
`SailChainId`, `SailDeployment`, `KnownTemplate`, `CloneTemplateInfo`, `CloneTemplateParam`, `ChainConfig`	Registry types.

Safe-address math

Export	Purpose
`computeSailSmaAddress`	Predict an SMA address from principals + salt (the deterministic address).
`computeKernelBoundSalt`	Compute `boundSalt = keccak256(saltNonce, caller, permissionSigner, manager, feePolicy)`.
`computeSafeProxyAddress`	Predict the Safe proxy CREATE2 address.
`buildSafeSetupInitializer`	Build the Safe `setup` calldata (with the module-enabler delegatecall).
`encodeSetManager`, `buildSetManagerExecTransaction`	Manager-rotation calldata / Safe exec.
`buildApprovedHashSignature`	Safe approved-hash signature helper.
`SAFE_V141`	Canonical Safe v1.4.1 addresses.
`gnosisSafeAbi`, `gnosisSafeExecAbi`, `safeModuleEnablerAbi`, `safeProxyFactoryAbi`	Safe-side ABIs.

Discovery, fees, and swaps

Export	Purpose
`discoverSafesForOwner`, `getSafeTransactionServiceUrl`	Find an owner’s Safes via the Safe transaction service.
`estimatePermissionFee`	Estimate the kernel registration fee.
`fetchLifiQuote`, `minTokenOut`, `encodeApprove`, `LIFI_ROUTERS`, `LIFI_QUOTE_URL`, `DEFAULT_SLIPPAGE`	Aggregator (LiFi) swap primitives behind `client.strategy.swap`.
`FetchLifiQuoteParams`, `LifiSwapQuote`	Swap quote types.

Keyring & ABIs

Export	Purpose
`LocalKeyring` (+ `EncryptedKeystore`, `LocalKeyringOptions`)	Load/sign with the encrypted manager key (geth keystore v3).
`SailKernelAbi`, `MandateFactoryAbi`, `SailGovernanceAbi`	Trusted-core ABIs.
Signing-server message types	`ClientMessage`, `ServerMessage`, `SigningRequest`, `SigningResponse`, `SigningTxRequest`, `SigningTypedDataRequest`, `SerializedTypedData`, …

Core domain types

Account, Mandate, MandateExplanation, Call, Dispatch, PreviewResult, SimulationResult, TxResult, DispatchOptions, SwapParams, SwapResult, Session, FeePolicy, PermissionTemplate, TemplateEncoder, TemplateExplainer, MandateItem, MandateDraftInput, SailorClientConfig, CreateAccountParams, RegisterAccountParams, plus the Agent / AgentContext types (The Agent interface).