solana-mobile 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 beeman https://github.com/beeman
+
+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,88 @@
+# solana-mobile
+
+TypeScript library for Solana development using [`@solana/kit`](https://github.com/anza-xyz/kit).
+
+## Features
+
+- **Bun, TypeScript, Biome, tsdown, Changesets, GitHub Actions** — batteries included
+- **`@solana/kit` client** — `createClient().use(rpc(...))` plugin pattern
+- **Explorer URL helper** — generate Solana Explorer links
+- **WebSocket URL derivation** — automatic `wss://` from `https://` RPC URLs
+- **E2E tests** — real Solana RPC tests via [Surfpool](https://github.com/txtx/surfpool) + [Testcontainers](https://github.com/beeman/testcontainers)
+
+## Installation
+
+```bash
+bun install
+```
+
+If you want to override the default RPC endpoint locally, copy the example env file first:
+
+```bash
+cp .env.example .env
+```
+
+## Usage
+
+```typescript
+import { createSolanaClient, getExplorerUrl } from 'solana-mobile'
+
+const client = createSolanaClient({ url: 'https://api.devnet.solana.com' })
+
+const slot = await client.rpc.getSlot().send()
+console.log(`Current slot: ${slot}`)
+
+const url = getExplorerUrl('tx/your-signature', 'devnet')
+```
+
+## CLI
+
+```bash
+# Check connectivity (defaults to devnet)
+bun run src/cli.ts
+
+# Custom RPC URL via argument
+bun run src/cli.ts https://api.mainnet-beta.solana.com
+
+# Or via environment variable
+SOLANA_ENDPOINT=https://api.mainnet-beta.solana.com bun run src/cli.ts
+```
+
+## Development
+
+```bash
+bun install
+bun run ruler:apply  # apply AI agent rules
+bun run build
+bun run check-types
+bun run lint
+bun test           # unit tests
+bun run test:e2e   # e2e tests (requires Docker)
+```
+
+## Testing
+
+Unit tests (`bun test`) run without any external dependencies.
+
+E2E tests (`bun run test:e2e`) spin up a [Surfpool](https://github.com/txtx/surfpool) container via [`@beeman/testcontainers`](https://github.com/beeman/testcontainers) and run real RPC calls against it. Docker must be running.
+
+#### Using solana-test-validator instead of Surfpool
+
+To switch the e2e tests to use `solana-test-validator`, update `test/e2e.test.ts`:
+
+```diff
+- import { createLocalSolanaClient, SurfpoolContainer, type StartedSurfpoolContainer } from '@beeman/testcontainers'
++ import { createLocalSolanaClient, SolanaTestValidatorContainer, type StartedSolanaTestValidatorContainer } from '@beeman/testcontainers'
+
+- let container: StartedSurfpoolContainer
++ let container: StartedSolanaTestValidatorContainer
+
+- container = await new SurfpoolContainer().start()
++ container = await new SolanaTestValidatorContainer().start()
+```
+
+The client API is identical — both containers expose `.url`, `.urlWs`, and work with `createLocalSolanaClient()`.
+
+## License
+
+MIT – see [LICENSE](./LICENSE).

package/dist/cli.cjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env bun
+const require_src = require("./src-B5DkELSU.cjs");
+//#region src/cli.ts
+async function main() {
+	const url = process.argv[2] ?? process.env.SOLANA_ENDPOINT ?? "https://api.devnet.solana.com";
+	const slot = await require_src.createSolanaClient({ url }).rpc.getSlot().send();
+	console.log(`Connected to ${url} — current slot: ${slot}`);
+}
+main();
+//#endregion
+
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","names":["createSolanaClient"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env bun\n\nimport { createSolanaClient } from './index.ts'\n\nasync function main() {\n  const url = process.argv[2] ?? process.env.SOLANA_ENDPOINT ?? 'https://api.devnet.solana.com'\n  const client = createSolanaClient({ url })\n\n  const slot = await client.rpc.getSlot().send()\n  console.log(`Connected to ${url} — current slot: ${slot}`)\n}\n\nmain()\n"],"mappings":";;;AAIA,eAAe,OAAO;CACpB,MAAM,MAAM,QAAQ,KAAK,MAAM,QAAQ,IAAI,mBAAmB;CAG9D,MAAM,OAAO,MAFEA,YAAAA,mBAAmB,EAAE,KAAK,CAAC,CAEhB,IAAI,SAAS,CAAC,MAAM;AAC9C,SAAQ,IAAI,gBAAgB,IAAI,mBAAmB,OAAO;;AAG5D,MAAM"}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,13 @@
+#!/usr/bin/env bun
+import { n as createSolanaClient } from "./src-B_8LrWmO.mjs";
+//#region src/cli.ts
+async function main() {
+	const url = process.argv[2] ?? process.env.SOLANA_ENDPOINT ?? "https://api.devnet.solana.com";
+	const slot = await createSolanaClient({ url }).rpc.getSlot().send();
+	console.log(`Connected to ${url} — current slot: ${slot}`);
+}
+main();
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env bun\n\nimport { createSolanaClient } from './index.ts'\n\nasync function main() {\n  const url = process.argv[2] ?? process.env.SOLANA_ENDPOINT ?? 'https://api.devnet.solana.com'\n  const client = createSolanaClient({ url })\n\n  const slot = await client.rpc.getSlot().send()\n  console.log(`Connected to ${url} — current slot: ${slot}`)\n}\n\nmain()\n"],"mappings":";;;AAIA,eAAe,OAAO;CACpB,MAAM,MAAM,QAAQ,KAAK,MAAM,QAAQ,IAAI,mBAAmB;CAG9D,MAAM,OAAO,MAFE,mBAAmB,EAAE,KAAK,CAAC,CAEhB,IAAI,SAAS,CAAC,MAAM;AAC9C,SAAQ,IAAI,gBAAgB,IAAI,mBAAmB,OAAO;;AAG5D,MAAM"}

package/dist/index.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_src = require("./src-B5DkELSU.cjs");
+exports.createSolanaClient = require_src.createSolanaClient;
+exports.getExplorerUrl = require_src.getExplorerUrl;
+exports.getWsUrl = require_src.getWsUrl;