The Lightspark JS+TS SDK

!npm (scoped)

This is the Lightspark Typescript SDK, which can be used either from a node or browser environment. It's used to manage accounts, nodes, wallets, etc. See the examples directory for some examples of how to use it!

Getting started

To use the SDK, you'll need to install it from npm:

``bash
$ npm install @lightsparkdev/lightspark-sdk
`

The entry-point to the SDK is the LightsparkClient class, which can be imported from the root package.
To create and authenticate a client from a server-environment, you'll need to provide your API token ID and secret. You can create these from the Lightspark API Tokens page.

`typescript
import { AccountTokenAuthProvider, LightsparkClient } from "@lightsparkdev/lightspark-sdk";

const TOKEN_ID = ;
// NOTE: This should be stored securely, e.g. in an environment variable and shouldn't be present in client-side code.
const TOKEN_SECRET = ;

const lightsparkClient = new LightsparkClient(
new AccountTokenAuthProvider(TOKEN_ID, TOKEN_SECRET)
);
`

If you want to use the client in a browser environment, you'll need to use a different authentication provider. The OAuthProvider can be used to authenticate with the user's Lightspark account. It will open a popup window to the Lightspark login page, and then exchange the authorization code for an access token.

You can then use the client to make API calls. For example, to create an invoice:

`typescript
const encodedInvoice = await lightsparkClient.createInvoice({
nodeId: RECEIVING_NODE_ID,
amountMsats: 100000,
memo: "Whasssupppp",
type: InvoiceType.AMP,
});

const invoiceDetails = await lightsparkClient.decodeInvoice(encodedInvoice);
console.log(invoiceDetails);
`

To complete sensitive operations like paying an invoice, you'll need to unlock the paying node using its node ID and password:

`typescript
const nodeID = ;
const nodePassword = ;

try {
await lightsparkClient.loadNodeSigningKey(nodeID, { password: nodePassword });
} catch (e) {
console.error("Failed to unlock node", e);
}

// Now we can pay the invoice.
const payment = await lightsparkClient.payInvoice(nodeID, encodedInvoice, 1000);
console.log(Payment details: ${payment});
`

You can also use the SDK to subscribe to events from the node, such as transaction updates. For example, to subscribe to transaction updates for a node:

`typescript
const nodeID = ;
let subscription;

function startListening(nodeId: string) {
if (subscription) {
return;
}
console.log("Starting to listen for transactions...");

subscription = lightsparkClient.listenToTransactions([nodeID]).subscribe({
next: (transaction) => {
if (transaction) {
console.log(Transaction updated! ${JSON.stringify(transaction)});
}
},
});
}

function stopListening() {
if (!subscription) {
return;
}
console.log("Stopping listening for transactions...");

subscription.unsubscribe();
subscription = undefined;
}
`

Examples

Several examples of SDK usage are included in the top-level examples directory.

$3

Try the node script examples using ts-node!

You'll need to set the following environment variables:

`bash
$ export LIGHTSPARK_API_TOKEN_CLIENT_ID=
$ export LIGHTSPARK_API_TOKEN_CLIENT_SECRET=
$ export LIGHTSPARK_TEST_NODE_PASSWORD=

If you want to run internal_example.ts, you'll also need to set these:


$ export LIGHTSPARK_EXAMPLE_NODE_1_NAME=
$ export LIGHTSPARK_EXAMPLE_NODE_2_NAME=
$ export LIGHTSPARK_EXAMPLE_NODE_2_PASSWORD=
`

Then, run the examples:

`bash
$ cd examples/node-scripts
$ npm install
$ npx ts-node createInvoice.ts -a "100" -m "Whasssupppp"
``