@nerochain/mpc-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NERO Network
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# @nerochain/mpc-sdk
+
+Browser-based threshold signature client for self-custodial wallets. Uses MPC-TSS (Multi-Party Computation Threshold Signature Schemes) to generate and manage Ethereum wallets from social logins.
+
+## Installation
+
+```bash
+npm install @nerochain/mpc-sdk
+```
+
+## Quick Start
+
+```typescript
+import { NeroMpcSDK } from "@nerochain/mpc-sdk";
+
+const sdk = new NeroMpcSDK({
+  backendUrl: "https://your-api.example.com",
+  chainId: 689, // NERO Testnet
+});
+
+await sdk.init();
+await sdk.connect("google");
+
+const address = await sdk.getAccounts();
+const signature = await sdk.signMessage("Hello NERO");
+```
+
+## React Integration
+
+```tsx
+import { NeroMpcAuthProvider, useNeroConnect, useNeroUser } from "@nerochain/mpc-sdk/react";
+
+function App() {
+  return (
+    <NeroMpcAuthProvider config={{ backendUrl: "https://your-api.example.com" }}>
+      <Wallet />
+    </NeroMpcAuthProvider>
+  );
+}
+
+function Wallet() {
+  const { connect, isLoading } = useNeroConnect();
+  const { user } = useNeroUser();
+
+  return user ? (
+    <p>Connected: {user.walletAddress}</p>
+  ) : (
+    <button onClick={() => connect("google")} disabled={isLoading}>
+      Login with Google
+    </button>
+  );
+}
+```
+
+## Package Exports
+
+| Export | Import Path | Description |
+|--------|------------|-------------|
+| Core SDK | `@nerochain/mpc-sdk` | Main SDK class, wallet operations, transport |
+| React | `@nerochain/mpc-sdk/react` | Provider, hooks, theme context |
+| Modal | `@nerochain/mpc-sdk/modal` | Pre-built login modal UI |
+| No Modal | `@nerochain/mpc-sdk/no-modal` | Headless SDK for custom UI |
+| Chains | `@nerochain/mpc-sdk/chains` | Chain configurations and manager |
+| Account Abstraction | `@nerochain/mpc-sdk/aa` | ERC-4337 smart account support |
+
+## Features
+
+- **Social Login** - Google, GitHub, Apple, and more via OAuth
+- **MPC-TSS** - Threshold signatures with 2-of-3 key shares
+- **DKLS Protocol** - True threshold ECDSA (key never reconstructed on server)
+- **ERC-4337** - Smart account support with bundler and paymaster
+- **Multi-Chain** - NERO Chain, Ethereum, Polygon, Arbitrum, Base
+- **React Hooks** - `useNeroConnect`, `useNeroUser`, `useNeroWallet`, and more
+- **External Wallets** - WalletConnect, MetaMask SDK, Coinbase Wallet
+- **Theming** - Full whitelabel support with light/dark modes
+
+## Peer Dependencies
+
+Required:
+- `@noble/curves` ^1.4.0
+- `@noble/hashes` ^1.4.0
+
+Optional (install based on features you use):
+- `react` ^18.0.0 || ^19.0.0 (for React hooks)
+- `@walletconnect/ethereum-provider` ^2.0.0 (for WalletConnect)
+- `@metamask/sdk` ^0.20.0 (for MetaMask)
+- `@coinbase/wallet-sdk` ^4.0.0 (for Coinbase Wallet)
+
+## License
+
+MIT

package/dist/aa.d.mts

@@ -0,0 +1,185 @@
+import { R as RpcConnection } from './chain-manager-C3eHsVt9.mjs';
+
+interface UserOperation {
+    sender: string;
+    nonce: bigint;
+    initCode: string;
+    callData: string;
+    callGasLimit: bigint;
+    verificationGasLimit: bigint;
+    preVerificationGas: bigint;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+    paymasterAndData: string;
+    signature: string;
+}
+interface UserOperationHex {
+    sender: string;
+    nonce: string;
+    initCode: string;
+    callData: string;
+    callGasLimit: string;
+    verificationGasLimit: string;
+    preVerificationGas: string;
+    maxFeePerGas: string;
+    maxPriorityFeePerGas: string;
+    paymasterAndData: string;
+    signature: string;
+}
+interface GasEstimate {
+    preVerificationGas: bigint;
+    verificationGasLimit: bigint;
+    callGasLimit: bigint;
+}
+interface UserOperationReceipt {
+    userOpHash: string;
+    entryPoint: string;
+    sender: string;
+    nonce: string;
+    paymaster: string;
+    actualGasCost: string;
+    actualGasUsed: string;
+    success: boolean;
+    logs: Array<{
+        address: string;
+        topics: string[];
+        data: string;
+    }>;
+    receipt: {
+        transactionHash: string;
+        transactionIndex: string;
+        blockHash: string;
+        blockNumber: string;
+        from: string;
+        to: string;
+        gasUsed: string;
+        status: string;
+    };
+}
+interface PaymasterResult {
+    paymasterAndData: string;
+    preVerificationGas?: bigint;
+    verificationGasLimit?: bigint;
+    callGasLimit?: bigint;
+}
+interface PaymasterContext {
+    mode?: "free" | "sponsored" | "erc20";
+    token?: string;
+    sponsorId?: string;
+}
+interface SimpleAccountFactoryData {
+    factoryAddress: string;
+    ownerAddress: string;
+    salt: bigint;
+}
+declare function userOpToHex(userOp: UserOperation): UserOperationHex;
+declare function userOpFromHex(userOpHex: UserOperationHex): UserOperation;
+
+interface BundlerClientConfig {
+    bundlerUrl: string;
+    entryPointAddress: string;
+    chainId: number;
+}
+declare class BundlerClient {
+    private bundlerUrl;
+    private entryPointAddress;
+    private requestId;
+    constructor(config: BundlerClientConfig);
+    sendUserOperation(userOp: UserOperation): Promise<string>;
+    estimateUserOperationGas(userOp: Partial<UserOperation>): Promise<GasEstimate>;
+    getUserOperationByHash(hash: string): Promise<UserOperationReceipt | null>;
+    getUserOperationReceipt(hash: string): Promise<UserOperationReceipt | null>;
+    getSupportedEntryPoints(): Promise<string[]>;
+    getChainId(): Promise<number>;
+    waitForUserOperationReceipt(hash: string, timeout?: number, interval?: number): Promise<UserOperationReceipt>;
+    private call;
+}
+declare function createBundlerClient(config: BundlerClientConfig): BundlerClient;
+
+interface PaymasterClientConfig {
+    paymasterUrl: string;
+    entryPointAddress: string;
+    chainId: number;
+}
+declare class PaymasterClient {
+    private paymasterUrl;
+    private entryPointAddress;
+    private chainId;
+    private requestId;
+    constructor(config: PaymasterClientConfig);
+    getPaymasterData(userOp: Partial<UserOperation>, context?: PaymasterContext): Promise<PaymasterResult>;
+    validatePaymasterUserOp(userOp: UserOperation): Promise<{
+        valid: boolean;
+        validAfter?: bigint;
+        validUntil?: bigint;
+    }>;
+    getSupportedTokens(): Promise<Array<{
+        address: string;
+        symbol: string;
+        decimals: number;
+    }>>;
+    getTokenPaymasterData(userOp: Partial<UserOperation>, tokenAddress: string): Promise<PaymasterResult>;
+    private partialUserOpToHex;
+    private call;
+}
+declare function createPaymasterClient(config: PaymasterClientConfig): PaymasterClient;
+
+interface SimpleAccountConfig {
+    ownerAddress: string;
+    factoryAddress: string;
+    entryPointAddress: string;
+    bundlerUrl: string;
+    paymasterUrl?: string;
+    chainId: number;
+    salt?: bigint;
+    rpcConnection: RpcConnection;
+}
+interface TransactionRequest {
+    to: string;
+    value?: bigint;
+    data?: string;
+}
+declare class SimpleAccount {
+    private ownerAddress;
+    private factoryAddress;
+    private entryPointAddress;
+    private salt;
+    private bundlerClient;
+    private paymasterClient;
+    private chainId;
+    private rpcConnection;
+    private _accountAddress;
+    private _isDeployed;
+    private _cachedNonce;
+    constructor(config: SimpleAccountConfig);
+    /**
+     * @deprecated Use getAccountAddress() instead. This sync getter is removed
+     * because address derivation now requires an RPC call to the factory.
+     */
+    get accountAddress(): string;
+    getAccountAddress(): Promise<string>;
+    isDeployed(): Promise<boolean>;
+    invalidateDeploymentCache(): void;
+    buildUserOperation(transactions: TransactionRequest | TransactionRequest[], options?: {
+        usePaymaster?: boolean;
+        paymasterContext?: PaymasterContext;
+    }): Promise<UserOperation>;
+    computeUserOpHash(userOp: UserOperation): string;
+    sendUserOperation(userOp: UserOperation): Promise<{
+        userOpHash: string;
+        wait: () => Promise<void>;
+    }>;
+    private fetchAccountAddressFromFactory;
+    private getInitCode;
+    private encodeExecute;
+    private packUserOp;
+    private getDummySignature;
+    private getNonce;
+    invalidateNonceCache(): void;
+    private estimateGas;
+    private getFeeData;
+    private getAccountCode;
+}
+declare function createSimpleAccount(config: SimpleAccountConfig): SimpleAccount;
+
+export { BundlerClient, type BundlerClientConfig, type GasEstimate, PaymasterClient, type PaymasterClientConfig, type PaymasterContext, type PaymasterResult, SimpleAccount, type SimpleAccountConfig, type SimpleAccountFactoryData, type TransactionRequest, type UserOperation, type UserOperationHex, type UserOperationReceipt, createBundlerClient, createPaymasterClient, createSimpleAccount, userOpFromHex, userOpToHex };

package/dist/aa.d.ts

@@ -0,0 +1,185 @@
+import { R as RpcConnection } from './chain-manager-C3eHsVt9.js';
+
+interface UserOperation {
+    sender: string;
+    nonce: bigint;
+    initCode: string;
+    callData: string;
+    callGasLimit: bigint;
+    verificationGasLimit: bigint;
+    preVerificationGas: bigint;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+    paymasterAndData: string;
+    signature: string;
+}
+interface UserOperationHex {
+    sender: string;
+    nonce: string;
+    initCode: string;
+    callData: string;
+    callGasLimit: string;
+    verificationGasLimit: string;
+    preVerificationGas: string;
+    maxFeePerGas: string;
+    maxPriorityFeePerGas: string;
+    paymasterAndData: string;
+    signature: string;
+}
+interface GasEstimate {
+    preVerificationGas: bigint;
+    verificationGasLimit: bigint;
+    callGasLimit: bigint;
+}
+interface UserOperationReceipt {
+    userOpHash: string;
+    entryPoint: string;
+    sender: string;
+    nonce: string;
+    paymaster: string;
+    actualGasCost: string;
+    actualGasUsed: string;
+    success: boolean;
+    logs: Array<{
+        address: string;
+        topics: string[];
+        data: string;
+    }>;
+    receipt: {
+        transactionHash: string;
+        transactionIndex: string;
+        blockHash: string;
+        blockNumber: string;
+        from: string;
+        to: string;
+        gasUsed: string;
+        status: string;
+    };
+}
+interface PaymasterResult {
+    paymasterAndData: string;
+    preVerificationGas?: bigint;
+    verificationGasLimit?: bigint;
+    callGasLimit?: bigint;
+}
+interface PaymasterContext {
+    mode?: "free" | "sponsored" | "erc20";
+    token?: string;
+    sponsorId?: string;
+}
+interface SimpleAccountFactoryData {
+    factoryAddress: string;
+    ownerAddress: string;
+    salt: bigint;
+}
+declare function userOpToHex(userOp: UserOperation): UserOperationHex;
+declare function userOpFromHex(userOpHex: UserOperationHex): UserOperation;
+
+interface BundlerClientConfig {
+    bundlerUrl: string;
+    entryPointAddress: string;
+    chainId: number;
+}
+declare class BundlerClient {
+    private bundlerUrl;
+    private entryPointAddress;
+    private requestId;
+    constructor(config: BundlerClientConfig);
+    sendUserOperation(userOp: UserOperation): Promise<string>;
+    estimateUserOperationGas(userOp: Partial<UserOperation>): Promise<GasEstimate>;
+    getUserOperationByHash(hash: string): Promise<UserOperationReceipt | null>;
+    getUserOperationReceipt(hash: string): Promise<UserOperationReceipt | null>;
+    getSupportedEntryPoints(): Promise<string[]>;
+    getChainId(): Promise<number>;
+    waitForUserOperationReceipt(hash: string, timeout?: number, interval?: number): Promise<UserOperationReceipt>;
+    private call;
+}
+declare function createBundlerClient(config: BundlerClientConfig): BundlerClient;
+
+interface PaymasterClientConfig {
+    paymasterUrl: string;
+    entryPointAddress: string;
+    chainId: number;
+}
+declare class PaymasterClient {
+    private paymasterUrl;
+    private entryPointAddress;
+    private chainId;
+    private requestId;
+    constructor(config: PaymasterClientConfig);
+    getPaymasterData(userOp: Partial<UserOperation>, context?: PaymasterContext): Promise<PaymasterResult>;
+    validatePaymasterUserOp(userOp: UserOperation): Promise<{
+        valid: boolean;
+        validAfter?: bigint;
+        validUntil?: bigint;
+    }>;
+    getSupportedTokens(): Promise<Array<{
+        address: string;
+        symbol: string;
+        decimals: number;
+    }>>;
+    getTokenPaymasterData(userOp: Partial<UserOperation>, tokenAddress: string): Promise<PaymasterResult>;
+    private partialUserOpToHex;
+    private call;
+}
+declare function createPaymasterClient(config: PaymasterClientConfig): PaymasterClient;
+
+interface SimpleAccountConfig {
+    ownerAddress: string;
+    factoryAddress: string;
+    entryPointAddress: string;
+    bundlerUrl: string;
+    paymasterUrl?: string;
+    chainId: number;
+    salt?: bigint;
+    rpcConnection: RpcConnection;
+}
+interface TransactionRequest {
+    to: string;
+    value?: bigint;
+    data?: string;
+}
+declare class SimpleAccount {
+    private ownerAddress;
+    private factoryAddress;
+    private entryPointAddress;
+    private salt;
+    private bundlerClient;
+    private paymasterClient;
+    private chainId;
+    private rpcConnection;
+    private _accountAddress;
+    private _isDeployed;
+    private _cachedNonce;
+    constructor(config: SimpleAccountConfig);
+    /**
+     * @deprecated Use getAccountAddress() instead. This sync getter is removed
+     * because address derivation now requires an RPC call to the factory.
+     */
+    get accountAddress(): string;
+    getAccountAddress(): Promise<string>;
+    isDeployed(): Promise<boolean>;
+    invalidateDeploymentCache(): void;
+    buildUserOperation(transactions: TransactionRequest | TransactionRequest[], options?: {
+        usePaymaster?: boolean;
+        paymasterContext?: PaymasterContext;
+    }): Promise<UserOperation>;
+    computeUserOpHash(userOp: UserOperation): string;
+    sendUserOperation(userOp: UserOperation): Promise<{
+        userOpHash: string;
+        wait: () => Promise<void>;
+    }>;
+    private fetchAccountAddressFromFactory;
+    private getInitCode;
+    private encodeExecute;
+    private packUserOp;
+    private getDummySignature;
+    private getNonce;
+    invalidateNonceCache(): void;
+    private estimateGas;
+    private getFeeData;
+    private getAccountCode;
+}
+declare function createSimpleAccount(config: SimpleAccountConfig): SimpleAccount;
+
+export { BundlerClient, type BundlerClientConfig, type GasEstimate, PaymasterClient, type PaymasterClientConfig, type PaymasterContext, type PaymasterResult, SimpleAccount, type SimpleAccountConfig, type SimpleAccountFactoryData, type TransactionRequest, type UserOperation, type UserOperationHex, type UserOperationReceipt, createBundlerClient, createPaymasterClient, createSimpleAccount, userOpFromHex, userOpToHex };