@effectstream/near-sandbox 0.100.13 → 0.100.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +42 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# @effectstream/near-sandbox
|
|
2
|
+
|
|
3
|
+
NPM wrapper around the
|
|
4
|
+
[NEAR sandbox](https://github.com/near/sandbox) binary — a single-node
|
|
5
|
+
NEAR chain for local development. Installs a pinned version into
|
|
6
|
+
`node_modules/.bin/near-sandbox` so the orchestrator can boot it
|
|
7
|
+
without each developer fetching it separately.
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
bun add @effectstream/near-sandbox
|
|
13
|
+
# or
|
|
14
|
+
npm install @effectstream/near-sandbox
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
The package downloads the pinned tarball for your OS/arch on install.
|
|
18
|
+
|
|
19
|
+
## Standalone usage
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
# Initialise + start a local NEAR sandbox
|
|
23
|
+
bunx near-sandbox init
|
|
24
|
+
bunx near-sandbox run
|
|
25
|
+
|
|
26
|
+
# Or invoke through this package
|
|
27
|
+
bun run --bun @effectstream/near-sandbox/start -- run
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Inside EffectStream
|
|
31
|
+
|
|
32
|
+
The orchestrator's NEAR step starts the sandbox alongside the
|
|
33
|
+
EffectStream sync layer so the
|
|
34
|
+
[`templates/near/`](https://github.com/PaimaStudios/paima-engine/tree/main/templates/near)
|
|
35
|
+
template runs end-to-end locally. On the runtime side,
|
|
36
|
+
`@effectstream/sync`'s `NearFetcher` consumes the sandbox's RPC.
|
|
37
|
+
|
|
38
|
+
## Links
|
|
39
|
+
|
|
40
|
+
- Docs: https://effectstream.github.io/docs/packages/binaries/near-sandbox
|
|
41
|
+
- Source: https://github.com/PaimaStudios/paima-engine/tree/main/packages/binaries/near-sandbox
|
|
42
|
+
- Upstream NEAR sandbox: https://github.com/near/sandbox
|