@elsoul/erpc-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ELSOUL LABO B.V.
+
+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,95 @@
+# `@elsoul/erpc-sdk`
+
+Official type-safe TypeScript client for [ERPC](https://erpc.global). Use one
+client and one API key for Solana, Ethereum, price data, indexed data, leader
+and validator data, analytics, subscriptions, and account information.
+
+## Install
+
+```bash
+npm install @elsoul/erpc-sdk
+# or: pnpm add @elsoul/erpc-sdk
+```
+
+The package has no runtime dependencies and includes ESM, CommonJS, and
+TypeScript declarations. Node.js 20 or later is supported.
+
+## Quick start
+
+```ts
+import { createErpcClient } from '@elsoul/erpc-sdk'
+
+const apiKey = process.env.ERPC_API_KEY
+if (!apiKey) throw new Error('ERPC_API_KEY is required')
+
+const erpc = createErpcClient({ apiKey })
+
+const slot = await erpc.solana.rpc.getSlot().send()
+const chainId = await erpc.ethereum.rpc.eth_chainId().send()
+
+console.log({ slot, chainId })
+erpc.close()
+```
+
+JSON-RPC method calls return pending requests. Call `.send()` to perform the
+network request.
+
+## Namespaces
+
+| Namespace | Purpose |
+| --- | --- |
+| `erpc.solana.rpc` | Solana JSON-RPC |
+| `erpc.solana.das` | Indexed assets and tokens |
+| `erpc.solana.history` | Address transactions and transfers |
+| `erpc.solana.leaders` | Leader slots and validator information |
+| `erpc.solana.analytics` | Epoch, slot, program, and TPS analytics |
+| `erpc.solana.subscriptions` | Enhanced WebSocket subscriptions |
+| `erpc.ethereum.rpc` | Ethereum JSON-RPC |
+| `erpc.ethereum.subscriptions` | Ethereum WebSocket subscriptions |
+| `erpc.price` | Price metadata, updates, and streams |
+| `erpc.account` | ERPC token balance |
+
+## Examples
+
+```ts
+const asset = await erpc.solana.das.getAsset({ id: assetId }).send()
+
+const block = await erpc.ethereum.rpc
+  .eth_getBlockByNumber('latest', false)
+  .send()
+
+const prices = await erpc.price.getLatestPriceUpdates({
+  ids: [feedId],
+  parsed: true,
+})
+
+const heads = await erpc.ethereum.subscriptions.subscribe(
+  'newHeads',
+  (header) => console.log(header),
+)
+
+await heads.unsubscribe()
+erpc.close()
+```
+
+## Raw methods
+
+The typed catalogs track methods available from ERPC. The raw API provides
+forward compatibility with newly introduced server methods:
+
+```ts
+const result = await erpc.solana.rpc
+  .raw<MyResult>('futureMethod', [{ enabled: true }])
+  .send()
+```
+
+## Documentation
+
+- [Complete guide](https://github.com/elsoul/erpc-sdk#readme)
+- [Method availability](https://github.com/elsoul/erpc-sdk/blob/main/docs/METHODS.md)
+- [Roadmap](https://github.com/elsoul/erpc-sdk/blob/main/ROADMAP.md)
+- [Security policy](https://github.com/elsoul/erpc-sdk/blob/main/SECURITY.md)
+
+## License
+
+[MIT](https://github.com/elsoul/erpc-sdk/blob/main/LICENSE)