toss-expo-sdk 0.1.0

package/lib/typescript/src/services/authService.d.ts

@@ -0,0 +1,55 @@
+import { Keypair, PublicKey } from '@solana/web3.js';
+import type { TossUser } from '../types/tossUser';
+export declare const SESSION_KEY = "toss_user_session";
+type UserSession = {
+    id: string;
+    token: string;
+    expiresAt: number;
+    walletAddress: string;
+};
+export declare class AuthService {
+    static signInWithWallet(walletAddress: string, isTemporary?: boolean): Promise<{
+        user: TossUser;
+        session: UserSession;
+    }>;
+    static saveSession(session: UserSession): Promise<void>;
+    static getSession(): Promise<UserSession | null>;
+    static signOut(): Promise<void>;
+    static isWalletUnlocked(): Promise<boolean>;
+    static unlockWalletWithBiometrics(): Promise<Keypair | null>;
+    /**
+     * Setup biometric-protected wallet (REQUIRED for security)
+     *
+     * SECURITY CRITICAL:
+     * - Private keypair is encrypted and stored in hardware-secure storage
+     * - Private key NEVER accessible without biometric authentication
+     * - User CANNOT export, backup, or access seed phrase
+     * - Keypair is device-specific and non-custodial
+     *
+     * @param keypair User's Solana keypair (never re-used or exported)
+     * @param useBiometrics Must be true (biometric is mandatory, not optional)
+     */
+    static setupWalletProtection(keypair: Keypair, useBiometrics?: boolean): Promise<void>;
+    /**
+     * Verify wallet is stored securely (requires biometric to access)
+     * @returns true if wallet exists and requires biometric
+     */
+    static isKeypairStoredSecurely(): Promise<boolean>;
+    /**
+     * Get public key only (NO AUTHENTICATION REQUIRED - public key is safe)
+     * Use this for displaying wallet address, sending funds to, etc.
+     */
+    static getPublicKeyWithoutAuth(): Promise<PublicKey | null>;
+    /**
+     * Lock wallet from memory (does NOT delete stored keypair)
+     * Keypair remains encrypted in secure storage
+     */
+    static lockWalletFromMemory(): Promise<void>;
+    /**
+     * Permanently delete wallet (IRREVERSIBLE)
+     * Only use for logout or account deletion
+     */
+    static deleteWalletPermanently(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=authService.d.ts.map

package/lib/typescript/src/services/authService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authService.d.ts","sourceRoot":"","sources":["../../../../src/services/authService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAI/C,KAAK,WAAW,GAAG;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAa,WAAW;WACT,gBAAgB,CAC3B,aAAa,EAAE,MAAM,EACrB,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;WAwCvC,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;WAIhD,UAAU,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;WAKzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;WAKxB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;WAQpC,0BAA0B,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA2DlE;;;;;;;;;;;OAWG;WACU,qBAAqB,CAChC,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,OAAc,GAC5B,OAAO,CAAC,IAAI,CAAC;IAoChB;;;OAGG;WACU,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKxD;;;OAGG;WACU,uBAAuB,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAajE;;;OAGG;WACU,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlD;;;OAGG;WACU,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;CAKtD"}

package/lib/typescript/src/storage/secureStorage.d.ts

@@ -0,0 +1,7 @@
+import type { SolanaIntent } from '../intent';
+export declare function secureStoreIntent(intent: SolanaIntent): Promise<void>;
+export declare function getSecureIntent(intentId: string): Promise<SolanaIntent | null>;
+export declare function getAllSecureIntents(): Promise<SolanaIntent[]>;
+export declare function removeSecureIntent(intentId: string): Promise<void>;
+export declare function clearAllSecureIntents(): Promise<void>;
+//# sourceMappingURL=secureStorage.d.ts.map

package/lib/typescript/src/storage/secureStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secureStorage.d.ts","sourceRoot":"","sources":["../../../../src/storage/secureStorage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAoB9C,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB3E;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAY9B;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAanE;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAexE;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3D"}

package/lib/typescript/src/storage.d.ts

@@ -0,0 +1,4 @@
+export declare function storePendingIntent(intent: any): Promise<void>;
+export declare function getPendingIntents(): Promise<any>;
+export declare function clearPendingIntents(): Promise<void>;
+//# sourceMappingURL=storage.d.ts.map

package/lib/typescript/src/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/storage.ts"],"names":[],"mappings":"AAIA,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,GAAG,iBAInD;AAED,wBAAsB,iBAAiB,iBAEtC;AAED,wBAAsB,mBAAmB,kBAExC"}

package/lib/typescript/src/sync.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Synchronisation with Solana Blockchain
+ *
+ * Implements Section 9 of the TOSS Technical Paper:
+ * Upon regaining connectivity, devices initiate reconciliation with onchain state.
+ * All offline artifacts are verified onchain and settled with deterministic outcomes.
+ */
+import { Connection, PublicKey } from '@solana/web3.js';
+import { type SettlementResult, type ReconciliationState } from './reconciliation';
+export interface SyncResult {
+    successfulSettlements: SettlementResult[];
+    failedSettlements: SettlementResult[];
+    detectedConflicts: {
+        intentId: string;
+        conflict: string;
+    }[];
+    reconciliationState: ReconciliationState;
+    syncTimestamp: number;
+    isComplete: boolean;
+}
+/**
+ * Full sync and reconciliation with the Solana blockchain
+ *
+ * This is the primary function for TOSS settlement. When a device regains
+ * connectivity, it calls this to:
+ * 1. Detect any conflicts with onchain state
+ * 2. Settle all pending intents
+ * 3. Update local state with results
+ *
+ * @param connection Connection to Solana RPC
+ * @param feePayer Optional fee payer keypair public key
+ * @returns Detailed sync results including conflicts and settlements
+ */
+export declare function syncToChain(connection: Connection, feePayer?: PublicKey): Promise<SyncResult>;
+/**
+ * Lightweight sync to check status without settling
+ * Useful for monitoring or UI updates without committing to settlements
+ */
+export declare function checkSyncStatus(connection: Connection): Promise<ReconciliationState>;
+//# sourceMappingURL=sync.d.ts.map

package/lib/typescript/src/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,UAAU;IAEzB,qBAAqB,EAAE,gBAAgB,EAAE,CAAC;IAE1C,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAEtC,iBAAiB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAE5D,mBAAmB,EAAE,mBAAmB,CAAC;IAEzC,aAAa,EAAE,MAAM,CAAC;IAEtB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,UAAU,EACtB,QAAQ,CAAC,EAAE,SAAS,GACnB,OAAO,CAAC,UAAU,CAAC,CAyCrB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

package/lib/typescript/src/types/tossUser.d.ts

@@ -0,0 +1,39 @@
+import { PublicKey } from '@solana/web3.js';
+/**
+ * Represents a TOSS wallet user in the ecosystem
+ */
+export type TossUser = {
+    userId: string;
+    username: string;
+    displayName?: string;
+    wallet: {
+        publicKey: PublicKey;
+        isVerified: boolean;
+        createdAt: string;
+    };
+    device: {
+        id: string;
+        name?: string;
+        lastActive: string;
+        client: 'mobile' | 'web' | 'desktop';
+    };
+    status: 'active' | 'inactive' | 'restricted';
+    lastSeen: string;
+    tossFeatures: {
+        canSend: boolean;
+        canReceive: boolean;
+        isPrivateTxEnabled: boolean;
+        maxTransactionAmount: number;
+    };
+    createdAt: string;
+    updatedAt: string;
+};
+/**
+ * Minimal user info for transaction context
+ */
+export type TossUserContext = Pick<TossUser, 'userId' | 'username' | 'wallet' | 'status'> & {
+    deviceId: string;
+    sessionId: string;
+};
+export declare const exampleTossUser: TossUser;
+//# sourceMappingURL=tossUser.d.ts.map

package/lib/typescript/src/types/tossUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tossUser.d.ts","sourceRoot":"","sources":["../../../../src/types/tossUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IAErB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,MAAM,EAAE;QACN,SAAS,EAAE,SAAS,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAGF,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;KACtC,CAAC;IAGF,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IAGjB,YAAY,EAAE;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IAGF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,QAAQ,EACR,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAC5C,GAAG;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,QAyB7B,CAAC"}

package/lib/typescript/src/utils/nonceUtils.d.ts

@@ -0,0 +1,8 @@
+import { PublicKey, Connection, Keypair } from '@solana/web3.js';
+export declare function createNonceAccount(connection: Connection, feePayer: Keypair, nonceAccount?: Keypair, amount?: number): Promise<{
+    nonceAccount: Keypair;
+    nonceAuth: PublicKey;
+}>;
+export declare function getNonce(connection: Connection, nonceAccount: PublicKey): Promise<string>;
+export declare function createNonceAdvanceInstruction(noncePubkey: PublicKey, authorizedPubkey: PublicKey): import("@solana/web3.js").TransactionInstruction;
+//# sourceMappingURL=nonceUtils.d.ts.map

package/lib/typescript/src/utils/nonceUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonceUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/nonceUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EAET,UAAU,EACV,OAAO,EAER,MAAM,iBAAiB,CAAC;AAEzB,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,OAAO,EACjB,YAAY,GAAE,OAA4B,EAC1C,MAAM,SAAuB,GAC5B,OAAO,CAAC;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,CAsB1D;AAED,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,SAAS,GACtB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,SAAS,EACtB,gBAAgB,EAAE,SAAS,oDAM5B"}

package/package.json

@@ -0,0 +1,176 @@
+{
+  "name": "toss-expo-sdk",
+  "version": "0.1.0",
+  "description": "The official React Native SDK for The Offline Solana Stack (TOSS)",
+  "type": "module",
+  "main": "./lib/module/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./lib/typescript/src/index.d.ts",
+        "default": "./lib/module/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/src/index.d.ts",
+        "default": "./lib/module/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "example": "yarn workspace toss-expo-sdk-example",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "toss",
+    "offline-solana",
+    "solana",
+    "solana-sdk",
+    "offline-sdk",
+    "react-native-sdk",
+    "react-native-solana",
+    "crypto",
+    "peer-to-peer",
+    "offline-first",
+    "offlinesolana"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zyppprotocol/toss-expo-sdk.git"
+  },
+  "author": "Joshua Idele (Zypp Protocol) <codewithjoshh@gmail.com> (https://github.com/Coding-With-Josh)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/zyppprotocol/toss-expo-sdk/issues"
+  },
+  "homepage": "https://github.com/zyppprotocol/toss-expo-sdk#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-native": ">=0.71"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native-community/cli": "latest",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.12",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-react-native": "^5.0.0",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "prettier": "^3.7.4",
+    "react": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-builder-bob": "^0.40.13",
+    "release-it": "^19.0.4",
+    "typescript": "^5.9.2"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "library",
+    "languages": "js",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.56.0"
+  },
+  "dependencies": {
+    "@arcium-hq/client": "^0.5.4",
+    "@chainsafe/libp2p-noise": "^17.0.0",
+    "@react-native-async-storage/async-storage": "^2.2.0",
+    "@solana/web3.js": "^1.98.4",
+    "bs58": "^6.0.0",
+    "expo-local-authentication": "^17.0.8",
+    "expo-secure-store": "^15.0.8",
+    "react-native-ble-plx": "^3.5.0",
+    "react-native-nfc-manager": "^3.17.2",
+    "react-native-vision-camera": "^4.7.3",
+    "tweetnacl": "^1.0.3",
+    "vision-camera-code-scanner": "^0.2.0"
+  }
+}

package/src/__tests__/index.test.tsx

@@ -0,0 +1 @@
+it.todo('write a test');