Skip to content

Publish the production mobile Bare runtime - #16

Merged
Jainakin merged 43 commits into
UTEXO-Protocol:mainfrom
Jainakin:hardik/mobile-wallet-native-runtime
Aug 17, 2026
Merged

Publish the production mobile Bare runtime#16
Jainakin merged 43 commits into
UTEXO-Protocol:mainfrom
Jainakin:hardik/mobile-wallet-native-runtime

Conversation

@Jainakin

@Jainakin Jainakin commented Aug 10, 2026

Copy link
Copy Markdown
Collaborator

Summary

Publishes the production-shaped Bare native runtime used by Iris Wallet and reconciles the wallet integration branch with the current RLN v0.11 binding surface.

Runtime surface

  • Coherent Bitcoin, Lightning, NIA, and IFA wallet snapshots.
  • Typed start/status/adopt/cancel handling for external-signer unlock.
  • Deterministic prepare/commit/cancel plans for BTC sends, RGB sends, and RGB UTXO setup.
  • Address receipt evidence and bounded pending-plan inspection.
  • Validated RGB transfer-consignment and contract-only imports.
  • RLN v0.11 linked-asset support and consolidated transaction/transfer filtering.
  • Durable VLS signer state, VSS writer identity, node ownership, shutdown, stale-handle rejection, and virtual-channel recovery.
  • Exact native provenance and symbol verification for source-built iOS and Android artifacts.

Immutable native provenance

  • RLN tag: v0.11.0-beta.3
  • RLN commit: f30a5393268de67c6bb5a1c525bc790c5b11afa2
  • Overlay: patches/c-ffi-utexo-patches-v0.11.0-beta.3.patch
  • Overlay SHA-256: a765ad577bb0e0a88cd15136074357babffd61e2c3dffde624017a2a3cc8983d
  • Hardened rgb-lib revision: 95332c41fd715939ac6e078ad859d474b1f6fa9b

The overlay applies cleanly to the exact pinned commit. The generated C header in this package is byte-for-byte derived from that overlaid source.

Merge reconciliation

This branch contains both the wallet-specific native contract and the APIs already merged into current main by #17:

  • assetLinkCreate
  • RLN v0.11 consolidated list filters
  • current wrapper lifecycle guards

Three stale wrappers discovered during reconciliation were moved to the closed-handle-safe require_sdk_node path. Explicit shutdown state also prevents the wrapper from issuing a duplicate direct shutdown during destroy/teardown.

Local validation

  • cargo fmt --all -- --check: passed on the overlaid RLN source.
  • RLN root cargo check --lib: passed.
  • C FFI cargo check: passed.
  • C FFI tests: 22/22 passed.
  • RLN root tests: 187 passed; 8 loopback-listener tests were blocked by the local sandbox and are delegated to GitHub CI.
  • Darwin ARM64 C FFI release static library: built successfully.
  • Darwin ARM64 Bare addon: compiled and linked successfully.
  • npm run check:types: passed.
  • Installer/provenance suite: 20/20 passed.
  • Full npm test: passed, including Bare to C FFI to tokio to LDK boot, persistent external signer, typed signer mismatch, explicit shutdown, closed-handle rejection, and signer-store release.
  • npm pack --dry-run: passed.

Review notes

This PR is intentionally broad because it publishes the complete mobile native contract accumulated on the iris-wallet branch. Merge updates source and CI contracts; release artifacts still follow the repository's normal release workflow.

Jainakin added 30 commits July 28, 2026 19:39
@Jainakin
Jainakin marked this pull request as ready for review August 17, 2026 11:16
@Jainakin
Jainakin merged commit b01639e into UTEXO-Protocol:main Aug 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant