orbis1-sdk-rn 0.0.1

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Orbis1
+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/Orbis1Sdk.podspec

@@ -0,0 +1,24 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Orbis1Sdk"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://www.github.com/Orbis-1/react-native-rgb.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.exclude_files = "ios/Rgb.h", "ios/Rgb.mm"
+  s.private_header_files = "ios/**/*.h"
+    
+  s.vendored_frameworks = "ios/rgb_libFFI.xcframework"
+  s.preserve_paths = "ios/rgb_libFFI.xcframework"
+
+  install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,269 @@
+# orbis1-sdk-rn
+
+Orbis1 SDK for React Native with RGB core, Watch Tower, and Gas-Free transfers.
+
+## Prerequisites
+
+- **Node.js** — Use the version in [`.nvmrc`](.nvmrc) (e.g. `v22.20.0`). [nvm](https://github.com/nvm-sh/nvm) recommended:
+  ```sh
+  nvm use
+  ```
+- **Yarn** — This repo uses [Yarn 4](https://yarnpkg.com/) (see `packageManager` in `package.json`). Use Yarn for all installs and scripts; npm is not supported for development.
+- **Android** (for running the example on Android):
+  - [React Native environment setup](https://reactnative.dev/docs/set-up-your-environment) (Android Studio, JDK 17, Android SDK, etc.)
+- **iOS** (for running the example on iOS):
+  - macOS only
+  - [Xcode](https://developer.apple.com/xcode/) and iOS Simulator or device
+  - [CocoaPods](https://cocoapods.org/) (installed via Bundler in the example app)
+  - The iOS native RGB framework (`rgb_libFFI.xcframework`) is downloaded automatically on `yarn` (postinstall) when run on macOS.
+
+## Installation
+
+To use the SDK in your app:
+
+```sh
+npm install orbis1-sdk-rn
+# or
+yarn add orbis1-sdk-rn
+```
+
+## Usage
+
+```js
+import {
+  Wallet,
+  generateKeys,
+  restoreKeys,
+  Interfaces,
+} from 'orbis1-sdk-rn';
+
+// Generate new keys
+const keys = await generateKeys(Interfaces.BitcoinNetwork.TESTNET);
+
+// Or restore from mnemonic
+const restoredKeys = await restoreKeys(
+  Interfaces.BitcoinNetwork.TESTNET,
+  'your mnemonic phrase here'
+);
+
+// Use the Wallet class for RGB operations, transfers, etc.
+const wallet = new Wallet(keys, /* ... */);
+```
+
+## Running the repository (development)
+
+This repo is a **monorepo** with Yarn workspaces: the library lives in the root and an **example app** in `example/`.
+
+### 1. Clone and install
+
+```sh
+git clone <repo-url>
+cd orbis1-sdk-rn
+```
+
+Use the correct Node version:
+
+```sh
+nvm use
+# or: node -v  should match .nvmrc (e.g. v22.20.0)
+```
+
+Install dependencies (required for both library and example):
+
+```sh
+yarn
+```
+
+- On **macOS**, `yarn` runs a postinstall script that downloads the iOS RGB framework (`rgb_libFFI.xcframework`) into `ios/`. If it’s already present, the download is skipped.
+- Do **not** use `npm install` for development; the project relies on Yarn workspaces.
+
+### 2. Build the library (optional)
+
+The example app uses the library from source. To build the library output (e.g. for publishing or typecheck):
+
+```sh
+yarn prepare
+# or: bob build
+```
+
+### 3. Run the example app
+
+The example app uses the **local** library, so JS/TS changes are picked up without rebuilding; native changes require a rebuild.
+
+**Start Metro (from repo root):**
+
+```sh
+yarn example start
+```
+
+In another terminal, run the app:
+
+**Android:**
+
+```sh
+yarn example android
+```
+
+**iOS (first time or after native dependency changes):**
+
+From the repo root:
+
+```sh
+cd example
+bundle install
+bundle exec pod install --project-directory=ios
+cd ..
+yarn example ios
+```
+
+Or from `example`:
+
+```sh
+cd example
+bundle install
+cd ios && bundle exec pod install && cd ..
+yarn ios
+```
+
+Subsequent runs (if you didn’t change native deps):
+
+```sh
+yarn example ios
+```
+
+### 4. Working with native code
+
+- **iOS:** Open `example/ios/Orbis1SdkExample.xcworkspace` in Xcode. Library native code is under **Pods → Development Pods → orbis1-sdk-rn**.
+- **Android:** Open `example/android` in Android Studio. Library code is under **orbis1-sdk-rn**.
+
+### 5. Verify New Architecture
+
+To confirm the example runs with the New Architecture, check the Metro logs for something like:
+
+```text
+Running "Orbis1SdkExample" with {"fabric":true,"initialProps":{"concurrentRoot":true},"rootTag":1}
+```
+
+(`fabric: true` and `concurrentRoot: true` indicate the New Architecture.)
+
+## Scripts (from repo root)
+
+| Command | Description |
+|--------|-------------|
+| `yarn` | Install dependencies (and on macOS, download iOS RGB framework) |
+| `yarn prepare` | Build the library (output in `lib/`) |
+| `yarn typecheck` | TypeScript type-check |
+| `yarn lint` | Run ESLint |
+| `yarn lint --fix` | Fix lint/format issues |
+| `yarn test` | Run unit tests (Jest) |
+| `yarn example start` | Start Metro for the example app |
+| `yarn example android` | Run the example app on Android |
+| `yarn example ios` | Run the example app on iOS |
+
+## Project structure
+
+```
+orbis1-sdk-rn/
+├── .github/                    # CI/CD and GitHub config
+│   ├── actions/
+│   │   └── setup/               # Reusable workflow: Node, Yarn cache, install
+│   │       └── action.yml
+│   ├── ISSUE_TEMPLATE/          # Bug report and issue config
+│   └── workflows/
+│       └── ci.yml              # Lint, typecheck, test, build lib, Android & iOS builds
+│
+├── android/                    # Native Android module (Kotlin)
+│   ├── build.gradle
+│   └── src/main/
+│       ├── AndroidManifest.xml
+│       └── java/com/orbis1sdk/
+│           ├── AppConstants.kt      # Build/config constants exposed to JS
+│           ├── Orbis1SdkModule.kt  # Turbo Module entry (New Architecture)
+│           ├── Orbis1SdkPackage.kt  # Package registration
+│           ├── RgbModule.kt        # RGB core native implementation (bridge to rgb lib)
+│           ├── RgbPackage.kt       # RGB native package registration
+│           └── WalletStore.kt      # Persistent wallet storage
+│
+├── ios/                        # Native iOS module (Swift + Obj-C)
+│   ├── AppConstants.swift      # Build/config constants exposed to JS
+│   ├── Orbis1Sdk.h / .mm       # Turbo Module Obj-C bridge
+│   ├── Rgb.h / .mm             # RGB module Obj-C bridge
+│   ├── Rgb.swift               # RGB Swift API
+│   ├── RgbLib.swift            # rgb_libFFI.xcframework bindings
+│   ├── WalletStore.swift       # Persistent wallet storage
+│   └── (rgb_libFFI.xcframework) # Downloaded by postinstall on macOS
+│
+├── scripts/
+│   └── download-rgb-lib-ios.js # Postinstall: fetches RGB iOS xcframework for macOS
+│
+├── src/                        # TypeScript/React Native library source
+│   ├── index.tsx               # Public API (exports, generateKeys, restoreKeys)
+│   ├── __tests__/
+│   │   └── index.test.tsx
+│   └── core/
+│       ├── Interfaces.ts      # Types, enums (BitcoinNetwork, Keys, etc.)
+│       ├── NativeRgb.ts        # Turbo Module spec / native bridge interface
+│       ├── RgbError.ts         # Error types and RgbError class
+│       └── Wallet.ts           # Wallet class (RGB ops, transfers, persistence)
+│
+├── example/                    # Example React Native app (Yarn workspace)
+│   ├── android/                # Example app Android project
+│   │   ├── app/                # App module (MainActivity, MainApplication, res)
+│   │   ├── build.gradle, settings.gradle, gradle.properties
+│   │   └── gradlew, gradle/wrapper/
+│   ├── ios/                    # Example app iOS project
+│   │   ├── Orbis1SdkExample/    # App target (AppDelegate, Info.plist, assets)
+│   │   ├── Orbis1SdkExample.xcworkspace  # Open this in Xcode (includes Pods)
+│   │   ├── Orbis1SdkExample.xcodeproj/
+│   │   ├── Podfile, Podfile.lock
+│   │   └── .xcode.env
+│   ├── src/
+│   │   └── App.tsx             # Example app UI
+│   ├── index.js                # App entry
+│   ├── package.json            # Deps: react, react-native; scripts: start, android, ios
+│   ├── metro.config.js
+│   ├── react-native.config.js  # Links to parent library
+│   ├── Gemfile / Gemfile.lock  # CocoaPods via Bundler
+│   └── app.json
+│
+├── lib/                        # Build output (from yarn prepare) — not committed
+│   ├── module/                 # Compiled JS (ESM)
+│   └── typescript/             # Generated .d.ts
+│
+├── package.json                # Library manifest, workspaces [example, docs], scripts
+├── Orbis1Sdk.podspec           # CocoaPods spec for iOS
+├── tsconfig.json / tsconfig.build.json
+├── babel.config.js
+├── eslint.config.mjs
+├── turbo.json                  # Turbo tasks: build:android, build:ios
+├── lefthook.yml                # Git hooks (e.g. commitlint)
+├── .nvmrc                      # Node version (e.g. v22.20.0)
+├── .yarnrc.yml                 # Yarn 4 config, workspace hoisting
+├── .yarn/releases/             # Pinned Yarn binary
+├── CONTRIBUTING.md
+├── CODE_OF_CONDUCT.md
+└── LICENSE
+```
+
+### Summary
+
+| Path | Purpose |
+|------|--------|
+| `src/` | Library TypeScript source and public API; built to `lib/` by react-native-builder-bob. |
+| `android/`, `ios/` | Native SDK implementation (Turbo Modules); linked into apps via the React Native CLI / CocoaPods. |
+| `example/` | Standalone app that depends on the local library; used to run and test the SDK. |
+| `scripts/` | Postinstall and other tooling (e.g. iOS RGB framework download). |
+| `.github/` | CI (lint, typecheck, test, build library, build example on Android and iOS). |
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+

package/android/build.gradle

@@ -0,0 +1,78 @@
+buildscript {
+  ext.Orbis1Sdk = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return Orbis1Sdk[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.orbis1sdk"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation("io.github.orbis-1:rgb-lib-android:0.3.0-beta.4")
+  implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3"
+  implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/orbis1sdk/AppConstants.kt

@@ -0,0 +1,25 @@
+package com.rgb
+
+import android.content.Context
+import java.io.File
+
+object AppConstants {
+  const val rgbDirName = ""
+  var appContext: Context? = null
+  var rgbDir: File? = null
+  const val backupName = "%s.rgb_backup"
+
+  @JvmStatic
+  fun initContext(context: Context) {
+    appContext = context
+    rgbDir = File(context.filesDir, rgbDirName)
+  }
+
+  @JvmStatic
+  fun ensureInitialized(context: Context) {
+    if (appContext == null || rgbDir == null) {
+      initContext(context)
+    }
+  }
+}
+

package/android/src/main/java/com/orbis1sdk/Orbis1SdkModule.kt

@@ -0,0 +1,15 @@
+package com.orbis1sdk
+
+import com.facebook.react.bridge.ReactApplicationContext
+
+class Orbis1SdkModule(reactContext: ReactApplicationContext) :
+  NativeOrbis1SdkSpec(reactContext) {
+
+  override fun multiply(a: Double, b: Double): Double {
+    return a * b
+  }
+
+  companion object {
+    const val NAME = NativeOrbis1SdkSpec.NAME
+  }
+}

package/android/src/main/java/com/orbis1sdk/Orbis1SdkPackage.kt

@@ -0,0 +1,33 @@
+package com.orbis1sdk
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class Orbis1SdkPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == Orbis1SdkModule.NAME) {
+      Orbis1SdkModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+    return ReactModuleInfoProvider {
+      val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+      moduleInfos[Orbis1SdkModule.NAME] = ReactModuleInfo(
+        Orbis1SdkModule.NAME,
+        Orbis1SdkModule.NAME,
+        false,  // canOverrideExistingModule
+        false,  // needsEagerInit
+        false,  // isCxxModule
+        true // isTurboModule
+      )
+      moduleInfos
+    }
+  }
+}