Reference
Networks and endpoints
Section titled “Networks and endpoints”| | Value |
|---|---|
| Network | Avalanche Fuji, chain ID 43113 |
| Paymaster (lane) | https://paymaster.0xgasless.com/v1/43113/rpc/<lane API key>, shared by KUMPLY |
| Bundler | https://bundler.0xgasless.com/43113 |
| RPC | https://api.avax-test.network/ext/bc/C/rpc |
| Explorer | testnet.snowtrace.io |
Contract addresses (Fuji)
Section titled “Contract addresses (Fuji)”| Contract | Address |
|---|---|
| KUMPLY AttestationStore | 0xa3Bc5564A18e107807aF41fF2a5215Db050b22dD |
| 0xGasless paymaster | 0xC68dAd686fcAe526dB286d84E1Fc8aDdc7b2FE98 |
| EntryPoint v0.6 | 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789 |
| Smart account factory | 0xF0b3f5146c2725e36d78F5029bc560eDfc67ADe0 |
| Smart account implementation | 0x8aF33bE7af021A6075aeB19b076fC75Bfbd2c5c3 |
| Fallback handler | 0xdA62055b0730d1d0621aD0A446DcD6057a6d951E |
| ECDSA ownership module | 0xcfb0BA514aa398085D63eC70cfEa6EC7f1094E8F |
Errors
Section titled “Errors”| Message | Cause | What to do |
|---|---|---|
| Sponsorship refused by attestation gate: sender … has no KUMPLY attestation | The smart account isn’t attested, or its attestation was revoked or has expired. | Make sure KUMPLY attested the smart account address, then run npm run verify. |
| Set PAYMASTER_URL in .env | The lane URL is missing. | Paste the lane URL from KUMPLY into .env. |
| InsufficientBalance | The lane’s Fuji budget is used up. | Tell the KUMPLY team so it can be topped up. |
| Invalid chain id | The bundler URL is wrong. | Use https://bundler.0xgasless.com/43113. |
Limits
Section titled “Limits”- Fuji testnet only. Nothing in the lane touches mainnet.
- Tier 5 (Know Your Agent) attestations only.
- Workshop attestations are demo attestations, issued by KUMPLY without an identity check.
Use it in your code
Section titled “Use it in your code”The SDK’s default contract addresses are for mainnet, so on Fuji pass the Fuji contracts explicitly:
import { createWalletClient, http } from "viem";import { privateKeyToAccount } from "viem/accounts";import { avalancheFuji } from "viem/chains";import { createECDSAOwnershipValidationModule, createSmartAccountClient, PaymasterMode,} from "@0xgasless/smart-account";
const signer = createWalletClient({ account: privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`), chain: avalancheFuji, transport: http("https://api.avax-test.network/ext/bc/C/rpc"),});
const ecdsaModule = await createECDSAOwnershipValidationModule({ signer, moduleAddress: "0xcfb0BA514aa398085D63eC70cfEa6EC7f1094E8F",});
const account = await createSmartAccountClient({ signer, chainId: 43113, rpcUrl: "https://api.avax-test.network/ext/bc/C/rpc", bundlerUrl: "https://bundler.0xgasless.com/43113", paymasterUrl: process.env.PAYMASTER_URL, // the KUMPLY lane URL factoryAddress: "0xF0b3f5146c2725e36d78F5029bc560eDfc67ADe0", implementationAddress: "0x8aF33bE7af021A6075aeB19b076fC75Bfbd2c5c3", defaultFallbackHandler: "0xdA62055b0730d1d0621aD0A446DcD6057a6d951E", defaultValidationModule: ecdsaModule, activeValidationModule: ecdsaModule,});
// Get THIS address attested by KUMPLYconsole.log(await account.getAccountAddress());
const res = await account.sendTransaction( { to: "0x...", data: "0x", value: 0n }, { paymasterServiceData: { mode: PaymasterMode.SPONSORED } },);const receipt = await res.wait();