Uptick AA Services
    • Uptick AA Services Developer Guide

    Uptick AA Services Developer Guide

    Welcome to the Uptick Services Developer Documentation! Uptick provides industry-leading full-stack infrastructure for ERC-4337 Account Abstraction (AA).
    Powered by Uptick AA Wallet SDK and Social Login SDK, it drastically lowers Web3 entry barriers, resolves pain points including private key management and Gas fee thresholds, and delivers an ultra-smooth user experience comparable to Web2 applications.

    1. What Is Uptick Services#

    Uptick Services is an all-in-one toolset dedicated to simplifying the creation, deployment, permission management and on-chain interaction processes of Uptick Chain Smart Accounts.

    Core Product Ecosystem#

    1.
    SDK Toolkit (@uptickjs)
    @uptickjs/uptick-aawallet-mpc-sdk: Core AA Wallet SDK, responsible for wallet initialization, MPC signature transactions, contract invocation and address derivation
    @uptickjs/webauth-sdk: Social Login SDK, supporting Google/Apple/email login, generating user-controlled EOA accounts and identity tokens
    2.
    Bundler
    High-performance compliant ERC-4337 bundler that aggregates UserOperations uniformly and broadcasts them on-chain with outstanding stability and efficiency
    3.
    Paymaster
    On-chain Gas sponsorship service. Projects can enable automatic fee deduction after configuration, enabling users to conduct zero-Gas-fee on-chain interactions

    2. Quick Start: React Embedded Wallet Integration#

    2.1 Install Dependencies#

    2.2 Prepare Developer Console#

    1.
    Log in to the Uptick Developer Dashboard
    2.
    Create a new application project and copy the exclusive project API Key, Bundler URL and Paymaster URL
    3.
    Top up UPTICK tokens for the project to ensure sufficient balance for Gas sponsorship

    2.3 Initialize WebAuth Social Login#

    2.4 Integrate Multi-channel Login#

    2.4.1 Email Verification Code Login#

    2.4.2 Google Social Login#

    Pre-configuration
    1.
    Create an OAuth application in Google Cloud Console
    2.
    Authorize redirect URI:
    https://uptickauth.uptick.network/api/auth/google/callback
    Code Implementation

    2.4.3 Apple Sign-in#

    Pre-configuration
    1.
    Create a Service ID in Apple Developer Console
    2.
    Enable Sign in with Apple and configure domain: auth.uptick.network
    3.
    Set authorization callback URL:
    https://auth.uptick.network/auth/apple/callback
    4.
    Generate .p8 private key and JWT client secret
    Code Implementation

    2.5 Initialize Core AA Wallet SDK#

    3. Core Business Process (Seamless Transition from Web2 to Web3)#

    Process 1: Obtain User Permissions via Social Login#

    Complete WebAuth login to acquire user EOA control address and identity authorization token

    Process 2: Automatically Derive User AA Contract Wallet Address#

    No manual wallet creation required. The SDK generates exclusive smart accounts automatically based on EOA addresses

    Process 3: Send Zero-Gas Sponsored Transactions#

    Transactions are automatically sponsored by Paymaster, users hold no native tokens required

    4. Core Configuration Parameters#

    ParameterFunctionRecommended Configuration
    bundlerUrlERC-4337 bundler endpoint for aggregating and uploading UserOpsExclusive link assigned by backend
    gasLimitMultiplierGas limit magnification ratio to avoid transaction failures caused by network congestion150 (1.5x)
    paymasterServiceUrlGas sponsorship service endpoint, core for zero-gas interactionExclusive link assigned by backend
    skipBundlerGasEstimateDisable bundler gas estimation, adopt local calculationtrue

    5. Launch Integration Checklist#

    Create project in Uptick Developer Console and obtain all three types of API keys
    Complete UPTICK token top-up and reserve sufficient balance for gas sponsorship
    Fill in correct chainId, contract addresses and service endpoints during SDK initialization
    Complete OAuth qualification application and callback domain configuration for Google & Apple login
    Fully test login flows including email, Google and Apple sign-in locally
    Finish joint debugging of zero-gas transfer and contract invocation functions

    6. Basic Core Concepts#

    1.
    ERC-4337 Account Abstraction
    Abandon traditional EOA external accounts, adopt smart contracts as user wallets to enable social recovery, batch transactions, gas sponsorship and other customizable features.
    2.
    Paymaster
    A fee escrow account managed by project parties. It verifies permissions and covers on-chain gas fees for end users, enabling frictionless zero-fee user interactions.
    3.
    MPC Multi-party Computation Signature
    Decentralized distributed signature solution with no private key custody, balancing top-tier security and convenient login experience.

    7. Official Community & Technical Support#

    Twitter: https://x.com/Uptickproject
    Telegram Group: https://t.me/uptickproject
    Discord: http://discord.com/invite/teqX78VZUV
    Developer Email: developer@uptickproject.com
    Modified at 2026-05-21 12:54:42
    Built with