Installation

v3.0.11

The SDK is served from the BetChain registry under the @softconstruct scope. Sign in via Get access, copy your license key from your account page, configure an authenticated .npmrc, then install — one package covers the Swarm, Casino and Content surfaces.

Install for

React / Vanilla JS

Flutter

Prerequisites

React19.x (peer dependency)

Node.js18 or newer

Package managernpm, yarn or pnpm

Module formatESM — the package has no CommonJS build

License keyshown on your account page after you sign in (Get access)

Private registry setup

The package is not on the public npm registry. Point the @softconstruct scope at the BetChain registry and authenticate with your license key.

Create .npmrc at your project root

Copy your key from your account page — one key authenticates the install, the MCP and the Flutter pub registry — then reference it through an environment variable so it never lands in your repository.

.sh

@softconstruct:registry=https://sdk.betconstruct.com/npm
//sdk.betconstruct.com/npm/:_authToken=${BETCHAIN_LICENSE_KEY}

Never commit the key

Keep .npmrc in .gitignore, or commit only the registry line and inject the key from your CI secret store.

BETCHAIN_LICENSE_KEY — placeholder

Keep the key privateIf a key is ever committed or shared, treat it as compromised. It expires after 30 days, so the exposure window is limited, and an admin can revoke it immediately via the license tools.

Install

.sh

npm install @softconstruct/betchain-core-client

Verify your installation

Confirm the package resolved from the private registry at the version you expect.

.sh

npm ls @softconstruct/betchain-core-client

You should see

.sh

[email protected]
└── @softconstruct/[email protected]

Update

v1 to v2 migration

Update to the latest patch or minor release. Major upgrades are covered by the migration guide.

.sh

npm update @softconstruct/betchain-core-client

Connect the MCP & install the Skill (optional)

Give your AI assistant live, correct SDK reference (MCP) and the BetChain build playbook (Skill). Both use the same license key — no extra credentials.

.sh

claude mcp add --transport http betchain https://sdk.betconstruct.com/mcp \
  --header "Authorization: Bearer ${BETCHAIN_LICENSE_KEY}"

One key, every toolThe MCP and the Skill both authenticate with the same BETCHAIN_LICENSE_KEY as the package install.

Troubleshooting

Still stuck? Use the Report issue action in the page sidebar and include the failing command plus the registry host sdk.betconstruct.com/npm.

Was this page helpful?

Next Error codes