@wirexapp/wpay-baas-sdk 0.1.6 → 0.1.8

package/README.md

@@ -64,6 +64,20 @@ if (!isPolicyInstalled || !isExecutorInstalled) {
 }
 ```
 
+**Single-signature alternative (steps 3 + 5 combined).** For a wallet with neither the
+executor nor the policy installed, `sdk.crypto.onboarding.allInOneStepOnboarding()` batches
+the executor install, the root-validator switch and the Accounts registration into one
+UserOperation, so the user signs once instead of three times:
+
+```typescript
+if (!isPolicyInstalled && !isExecutorInstalled) {
+  const receipt = await sdk.crypto.onboarding.allInOneStepOnboarding();
+  console.log('Transaction hash:', receipt.receipt.transactionHash);
+} else {
+  // fall back to the per-step calls below
+}
+```
+
 ### 4: If you use Privy as auth — Link Smart Wallet to Privy (SIWE)
 
 ```typescript
@@ -208,10 +222,17 @@ interface RegisterCompanyParams {
 | `getSmartWalletClientWithoutPolicy()` | Get Kernel client without Policy |
 | `getSmartAccountSigner()` | Get signer for Smart Account |
 | `getMainWalletClient()` | Get main wallet client |
-| `sendUserOperationsAndWaitReceipt(callData, smartWalletClient?)` | Send user operations and wait for receipt |
-| `sendUserOperationsWithNonceAndWaitReceipt(callData, nonce)` | Send user operations with specific nonce |
+| `sendUserOperationsAndWaitReceipt(callData, smartWalletClient?, config?)` | Send user operations and wait for receipt |
+| `sendUserOperationsWithNonceAndWaitReceipt(callData, nonce, config?)` | Send user operations with specific nonce |
 | `invalidateLocalCache()` | Clear cached wallet clients |
 
+`config` on both send methods is `{ waitOnChainBlocks?: number; applyUnwrapGasFloor?: boolean }`.
+`applyUnwrapGasFloor` estimates the UserOperation first and raises `callGasLimit` to a 1_500_000
+floor when the estimate comes back lower. The transfer service sets it for the batches that unwrap
+a synthetic token before transferring (`makeErc20TransferFull` execution step,
+`makeErc20TransferFinal`, `makeTransferWithoutDelayPolicy`); plain transfers, policy installs and
+batch transfers keep the bundler estimate.
+
 ### `sdk.crypto.accountAbstraction` — Account Abstraction Service
 
 | Method | Description |
@@ -221,6 +242,8 @@ interface RegisterCompanyParams {
 | `signInPolicyAndExecutor()` | Install Policy and Executor together |
 | `signInPolicy()` | Install Policy only |
 | `signInExecutor()` | Install Executor only |
+| `getExecutorInstallCall()` | Executor install as a batchable call (used by onboarding) |
+| `getPolicyInstallCall()` | Policy install as a batchable call (used by onboarding) |
 
 ### `sdk.crypto.accountContract` — Account Contract Service
 
@@ -230,6 +253,13 @@ interface RegisterCompanyParams {
 | `registerInAccounts()` | Register wallet in Accounts contract (retail) |
 | `isWalletInCorporateAccounts()` | Check if wallet is registered in Corporate Accounts contract |
 | `registerInCorporateAccounts()` | Register wallet in Corporate Accounts contract (B2B) |
+| `getAccountRegistrationCall()` | Accounts registration as a batchable call (used by onboarding) |
+
+### `sdk.crypto.onboarding` — Onboarding Service
+
+| Method | Description |
+|--------|-------------|
+| `allInOneStepOnboarding()` | Executor install + policy switch + Accounts registration in a single UserOperation, signed by the pre-policy client. Use only when neither the executor nor the policy is installed; otherwise run the per-step methods. |
 
 ### `sdk.crypto.transfer` — Transfer Service