@discoin/scambio

The official JS/TS library for Discoin. Features browser and first-class TypeScript support.

Usage

Install

yarn add @discoin/scambio

# Or for npm

npm i @discoin/scambio

# Or for pnpm

pnpm i @discoin/scambio

If you want to do more complex queries you may want to use the @nestjsx/crud-request package, which is specifically designed for the Discoin API. Most users won't need it but it is listed as a peer dependency. You can safely ignore any warnings about it if you aren't using it.

Examples

Below are several examples of how you can use the library. You do everything through a client instance or its static members.

Creating a new client

ECMAScript modules

import Discoin from '@discoin/scambio';

const client = new Discoin('token', ['currencyCode']);

CommonJS

const Discoin = require('@discoin/scambio').default;

const client = new Discoin('token', ['currencyCode']);

Creating a transaction

const newTransaction = client.transactions.create({
    from: 'XYZ',
    to: 'ABC',
    amount: 100,
    // Discord user ID
    user: '210024244766179329',
});

Getting transactions

Get one transaction by ID

await client.transactions.getOne('808179ef-aef4-4bbb-ab37-db310235fb0c');

Get many transactions with built-in queries

This uses common queries, which are generated specifically for your client and don't need any extra dependencies.

await client.transactions.getMany(client.commonQueries.UNHANDLED_TRANSACTIONS);

Get many transactions with query builder

This uses the @nestjsx/crud-request query builder. You should use this when you are performing very complex queries or are dynamically creating queries.

import {RequestQueryBuilder, CondOperator} from '@nestjsx/crud-request';

const query = RequestQueryBuilder.create()
    // Only get transactions where the `amount` field > 10
    .setFilter({
        field: 'amount',
        operator: CondOperator.GREATER_THAN,
        value: 10,
    })
    .query();

await client.transactions.getMany(query);

Processing transactions

You can mark a transaction as handled after you have paid the user. This helps to keep transactions atomic and can make retrying failed transactions very simple.

const unhandledTransactions = await client.transactions.getMany(client.commonQueries.UNHANDLED_TRANSACTIONS);

unhandledTransactions.forEach(async transaction => {
    console.log(`${transaction.user} received ${transaction.payout} ${transaction.to.id}`);

    // After you're done with the transaction, mark it as completed
    await transaction.update({handled: true});
});

Contributing

Pull requests and issues are always welcome! Please, read our Code of Conduct and our contributing guide if you are interested in helping to improve the library..

Licence

If you would like the licence to be something other than MIT for you or your organization please get in touch.