Loop SDK

Loop SDK lets dApps connect to a Loop wallet on mobile or desktop, read holdings and contracts, and ask the user to sign DAML transactions. A server SDK is also available for backends that hold their own keys.

Documentation: docs.fivenorth.io/loop-sdk

CIP-103 provider

Use loop.getCip103Provider() after loop.init() to access Canton dApp API 0.5.0. Existing Loop methods remain available. See the CIP-103 guide for supported methods, ledger endpoints, and compatibility notes, including unconfirmed transaction outcomes.

Install

bun add @fivenorth/loop-sdk

Or without a build step:

import { loop } from 'https://unpkg.com/@fivenorth/[email protected]/dist';

Quickstart

import { loop } from '@fivenorth/loop-sdk';

loop.init({
    appName: 'My dApp',
    network: 'mainnet', // or 'devnet', 'local'
    onAccept: async (provider) => {
        const holdings = await provider.getHolding();
        console.log(provider.party_id, holdings);
    },
    onReject: () => console.log('Connection rejected'),
});

loop.connect(); // shows the QR code / wallet prompt

Docs

• Overview and supported contracts
• Usage guide: connecting, provider methods, submitting transactions
• CIP-103 provider
• Server API: signing without a wallet popup
• Custom contracts: getting your own DAR reviewed and deployed
• API reference
• Live demo
• Changelog and security policy

Development Guide

This section is only for developing the SDK itself. To use the SDK, see the docs.

To install dependencies:

bun install

To run the dev server, which also recompiles the SDK on change:

bun start

Then visit http://localhost:3030/ to see the local demo app served from demo/test.html.

Visit http://localhost:3030/cip103 for the CIP-103 demo.