{"_id":"@atomiqlabs/storage-rn-async","_rev":"5-4a22a9da78d153ad7b5e27f787e2b081","name":"@atomiqlabs/storage-rn-async","dist-tags":{"latest":"2.0.1","next":"2.0.0"},"versions":{"1.0.0":{"name":"@atomiqlabs/storage-rn-async","version":"1.0.0","keywords":["Bitcoin","Cross-chain","Cryptocurrency","Bridge","Trustless"],"author":{"name":"adambor"},"license":"ISC","_id":"@atomiqlabs/storage-rn-async@1.0.0","maintainers":[{"name":"adambor","email":"adamborcany@gmail.com"}],"dist":{"shasum":"a01dcba65cd5961a7140f7a53f68a4f54f85a7be","tarball":"https://registry.npmjs.org/@atomiqlabs/storage-rn-async/-/storage-rn-async-1.0.0.tgz","fileCount":15,"integrity":"sha512-KJd2W1BRy50ZOWF8aRSnZPWme1w6+mgyFcSCwvS/qsrhZRlDSeZTaWT7FDBNFGTyKWgY7rI+iLP2sx2ZRT1XzQ==","signatures":[{"sig":"MEUCIGO7fBUB+sH8IUkfFNP9aWI96ey8sWeotEArlop3utFcAiEA+W0JzwAISgaggjagHtz7FX5CmcvTGAxJWcxdmobM6FM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24711},"main":"./dist/index.js","types":"./dist/index.d.ts","types:":"./dist/index.d.ts","scripts":{"test":"jest"},"_npmUser":{"name":"adambor","email":"adamborcany@gmail.com"},"_npmVersion":"10.5.0","description":"A react native async-storage implementation for atomiqlabs SDK","directories":{},"_nodeVersion":"18.20.2","dependencies":{"@atomiqlabs/base":"^11.0.0","@atomiqlabs/sdk-lib":"^15.0.16","@atomiqlabs/storage-memory-indexed-kv":"^1.0.0","@react-native-async-storage/async-storage":"^2.2.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"4.9.5","@types/node":"22.9.3"},"_npmOperationalInternal":{"tmp":"tmp/storage-rn-async_1.0.0_1760027048043_0.9907502866054945","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@atomiqlabs/storage-rn-async","version":"1.0.1","keywords":["Bitcoin","Cross-chain","Cryptocurrency","Bridge","Trustless"],"author":{"name":"adambor"},"license":"ISC","_id":"@atomiqlabs/storage-rn-async@1.0.1","maintainers":[{"name":"adambor","email":"adamborcany@gmail.com"}],"dist":{"shasum":"8ae15322eb2e3bb11369902f81a66a9fa8a894a3","tarball":"https://registry.npmjs.org/@atomiqlabs/storage-rn-async/-/storage-rn-async-1.0.1.tgz","fileCount":15,"integrity":"sha512-vazNaFtgEYeO8IecIiaFSORXlbydVKDHTiIN5Rzsn7E/zYafrbIYlmsrN1SD4X5WuuHk2SaZq2DABN9bZDC1sg==","signatures":[{"sig":"MEQCIF+PSWrStzWUI8ALLfIeQzzqa0DwBttn1ZvrcujWxlDfAiAMZrl+JfEbfW+fXHjHp4HLRZpaeC7LaaMrSGQUo5UR+A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24760},"main":"./dist/index.js","types":"./dist/index.d.ts","types:":"./dist/index.d.ts","scripts":{"test":"jest"},"_npmUser":{"name":"adambor","email":"adamborcany@gmail.com"},"_npmVersion":"10.5.0","description":"A react native async-storage implementation for atomiqlabs SDK","directories":{},"_nodeVersion":"18.20.2","dependencies":{"@atomiqlabs/storage-memory-indexed-kv":"^1.0.1","@react-native-async-storage/async-storage":"^2.2.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"4.9.5","@types/node":"22.9.3"},"peerDependencies":{"@atomiqlabs/base":">=11.0.0 <13.0.0","@atomiqlabs/sdk-lib":">=15.0.16 <17.0.0"},"_npmOperationalInternal":{"tmp":"tmp/storage-rn-async_1.0.1_1760048796244_0.5412581069348643","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@atomiqlabs/storage-rn-async","version":"2.0.0","keywords":["Bitcoin","Cross-chain","Cryptocurrency","Bridge","Trustless"],"author":{"name":"adambor"},"license":"ISC","_id":"@atomiqlabs/storage-rn-async@2.0.0","maintainers":[{"name":"adambor","email":"adamborcany@gmail.com"}],"dist":{"shasum":"5dd7e8b73c961a565964699b87846ba5f1702beb","tarball":"https://registry.npmjs.org/@atomiqlabs/storage-rn-async/-/storage-rn-async-2.0.0.tgz","fileCount":15,"integrity":"sha512-dfy7tf+aq0kWbiv7DGNPpsR/x8EtJJgJr4S8w5mYhIRQQAXO/KGc1sx/uzEhbbwjEB1nUOxkHQlAH3rGjLCzlQ==","signatures":[{"sig":"MEUCIQDPM5TbHK1v0Qu78ldHy76CiyhUPwJdJodgvhSP0QPKjAIgROqLOEb96BVG6Z9pDP/jB6VeSyYTMF5tLlkorvJ6oLU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29593},"main":"./dist/index.js","types":"./dist/index.d.ts","types:":"./dist/index.d.ts","gitHead":"0e4b5f1b1d8c81546cd71fb98b28cf47a1c9e782","scripts":{"test":"jest","build:ts4":"npx -p typescript@4.9 tsc --noEmit","build:ts5":"npx -p typescript@5 tsc --noEmit"},"_npmUser":{"name":"adambor","email":"adamborcany@gmail.com"},"_npmVersion":"11.6.0","description":"A react native async-storage implementation for atomiqlabs SDK","directories":{},"_nodeVersion":"24.9.0","dependencies":{"@atomiqlabs/storage-memory-indexed-kv":"^2.0.3","@react-native-async-storage/async-storage":"^2.2.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":">=4","@types/node":"22.9.3"},"_npmOperationalInternal":{"tmp":"tmp/storage-rn-async_2.0.0_1769622768390_0.28118523904660186","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@atomiqlabs/storage-rn-async","version":"2.0.1","description":"A react native async-storage implementation for atomiqlabs SDK","main":"./dist/index.js","types:":"./dist/index.d.ts","scripts":{"test":"jest","build:ts4":"npx -p typescript@4.9 tsc --noEmit","build:ts5":"npx -p typescript@5 tsc --noEmit"},"keywords":["Bitcoin","Cross-chain","Cryptocurrency","Bridge","Trustless"],"author":{"name":"adambor"},"license":"ISC","dependencies":{"@atomiqlabs/storage-memory-indexed-kv":"^2.0.3","@react-native-async-storage/async-storage":"^2.2.0"},"devDependencies":{"@types/node":"22.9.3","typescript":">=4"},"_id":"@atomiqlabs/storage-rn-async@2.0.1","gitHead":"d72db35bdcf39750e50ed13a90edb5c50b764a5b","types":"./dist/index.d.ts","_nodeVersion":"24.9.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-krAztHujTQqYzUEUMEOhtZndVmo12z2NjX3Im8L9/KzH+u4qvkrrm3anhKPZJdMpETkQbFAzb5NJU4+ftpux8g==","shasum":"498c258bb326ebd004856038817e2b0e05b7213c","tarball":"https://registry.npmjs.org/@atomiqlabs/storage-rn-async/-/storage-rn-async-2.0.1.tgz","fileCount":15,"unpackedSize":39924,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDZSC+Jb+aov1Ds0L9gCFzQSp8Ng8DYSRqKIxX5TL/nlQIgHuINQLeWyAYahKnSqUr+jTokKh+8NFrchhm0jDCa5jA="}]},"_npmUser":{"name":"adambor","email":"adamborcany@gmail.com"},"directories":{},"maintainers":[{"name":"adambor","email":"adamborcany@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/storage-rn-async_2.0.1_1776956632996_0.8806568404647019"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-09T16:24:07.946Z","modified":"2026-04-23T15:03:53.251Z","1.0.0":"2025-10-09T16:24:08.228Z","1.0.1":"2025-10-09T22:26:36.433Z","2.0.0":"2026-01-28T17:52:48.577Z","2.0.1":"2026-04-23T15:03:53.131Z"},"author":{"name":"adambor"},"license":"ISC","keywords":["Bitcoin","Cross-chain","Cryptocurrency","Bridge","Trustless"],"description":"A react native async-storage implementation for atomiqlabs SDK","maintainers":[{"name":"adambor","email":"adamborcany@gmail.com"}],"readme":"# @atomiqlabs/storage-rn-async\n\n`@atomiqlabs/storage-rn-async` is the React Native storage adapter for the Atomiq SDK. The SDK uses browser IndexedDB by default. React Native does not have browser IndexedDB, so mobile apps need to provide storage explicitly. This package does that by using `@react-native-async-storage/async-storage` as the backend.\n\n## What this package provides\n\n- `RNAsyncUnifiedStorage`: persistent unified swap storage used by the SDK for swap records and indexed queries.\n- `RNAsyncStorageManager`: persistent storage manager used for chain-specific SDK stores.\n\nEach constructor takes a key prefix so your app can namespace Atomiq data inside AsyncStorage.\n\n## When to use it\n\nUse this package when you run the Atomiq SDK in:\n\n- React Native mobile apps\n- Expo / React Native runtimes with AsyncStorage available\n\nIf you run the SDK in the browser, you usually do not need this package because the SDK already uses IndexedDB there.\n\n## Installation\n\n```bash\nnpm install @atomiqlabs/sdk @atomiqlabs/storage-rn-async\n```\n\nThis adapter uses `@react-native-async-storage/async-storage` under the hood, so your React Native app must support that package.\n\n## SDK Usage\n\nPass `RNAsyncUnifiedStorage` as `swapStorage` and `RNAsyncStorageManager` as `chainStorageCtor` when creating the swapper.\n\n```typescript\nimport {BitcoinNetwork, SwapperFactory, TypedSwapper} from \"@atomiqlabs/sdk\";\nimport {RNAsyncStorageManager, RNAsyncUnifiedStorage} from \"@atomiqlabs/storage-rn-async\";\n\nconst chains = [SolanaInitializer, StarknetInitializer, CitreaInitializer] as const;\ntype SupportedChains = typeof chains;\n\nconst Factory = new SwapperFactory<SupportedChains>(chains);\n\nconst swapper: TypedSwapper<SupportedChains> = Factory.newSwapper({\n    chains: {\n        ...\n    },\n    bitcoinNetwork: BitcoinNetwork.MAINNET,\n    // React Native does not provide the browser IndexedDB storage\n    // used by default in web environments, so provide AsyncStorage-backed adapters.\n    swapStorage: chainId => new RNAsyncUnifiedStorage(`atomiq_sdk_chain_${chainId}_`),\n    chainStorageCtor: name => new RNAsyncStorageManager(`atomiq_sdk_store_${name}_`)\n});\n\nawait swapper.init();\n```\n\n## Notes\n\n- Both storage adapters store data under the prefixes you pass in, so pick stable prefixes that do not collide with the rest of your app's AsyncStorage keys.\n- `RNAsyncUnifiedStorage` builds the SDK's indexed storage behavior on top of AsyncStorage, which is a plain key-value backend, hence the indexing is handled in-memory - this is therefore only suitable for single-client environments with <10,000 swaps saved.\n- Persistence depends on the durability of the app's AsyncStorage data on the device.\n","readmeFilename":"README.md"}