# btms-core Tools for creating and managing UTXO-based tokens ## Installation npm i btms-core ## Example Usage ```ts // todo ``` ## Documentation Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes) ### Interfaces | | | --- | | [Asset](#interface-asset) | | [IncomingPayment](#interface-incomingpayment) | | [OverlaySearchResult](#interface-overlaysearchresult) | | [OwnershipProof](#interface-ownershipproof) | | [SubmitResult](#interface-submitresult) | | [TokenForRecipient](#interface-tokenforrecipient) | Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes) --- #### Interface: Asset ```ts export interface Asset { assetId: string; balance: number; name?: string; iconURL?: string; metadata?: string; incoming?: boolean; incomingAmount?: number; new?: boolean; } ``` Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes) --- #### Interface: TokenForRecipient ```ts export interface TokenForRecipient { txid: string; vout: number; amount: number; envelope: CreateActionResult; keyID: string; outputScript: string; } ``` Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes) --- #### Interface: SubmitResult ```ts export interface SubmitResult { status: "auccess"; topics: Record; } ``` Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes) --- #### Interface: OverlaySearchResult ```ts export interface OverlaySearchResult { inputs: string | null; mapiResponses: string | null; outputScript: string; proof: string | null; rawTx: string; satoshis: number; txid: string; vout: number; } ``` Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes) --- #### Interface: IncomingPayment ```ts export interface IncomingPayment { txid: string; vout: number; outputScript: string; amount: number; token: TokenForRecipient; sender: string; messageId: string; keyID: string; envelope: CreateActionResult; } ``` Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes) --- #### Interface: OwnershipProof ```ts export interface OwnershipProof { prover: string; verifier: string; assetId: string; amount: number; tokens: { output: GetTransactionOutputResult; linkage: SpecificKeyLinkageResult; }[]; } ``` Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes) --- ### Classes #### Class: BTMS The BTMS class provides an interface for managing and transacting assets using the Babbage SDK. ```ts export class BTMS { confederacyHost: string; peerServHost: string; tokenator: Tokenator; tokensMessageBox: string; marketplaceMessageBox: string; protocolID: string; basket: string; tokenTopic: string; satoshis: number; authrite: Authrite; privateKey: string | undefined; marketplaceTopic: string; constructor(confederacyHost = "https://confederacy.babbage.systems", peerServHost = "https://peerserv.babbage.systems", tokensMessageBox = "tokens-box", protocolID = "tokens", basket = "tokens", tokensTopic = "tokens", satoshis = 1000, privateKey?: string, marketplaceMessageBox = "marketplace", marketplaceTopic = "marketplace") async listAssets(): Promise async issue(amount: number, name: string): Promise async send(assetId: string, recipient: string, sendAmount: number, disablePeerServ = false, onPaymentSent = (payment: TokenForRecipient) => { }): Promise async listIncomingPayments(assetId: string): Promise async acceptIncomingPayment(assetId: string, payment: IncomingPayment): Promise async refundIncomingTransaction(assetId: string, payment: IncomingPayment): Promise async getTokens(assetId: string, includeEnvelope = true): Promise async getBalance(assetId: string, myTokens?: GetTransactionOutputResult[]): Promise async getTransactions(assetId: string, limit: number, offset: number): Promise<{ transactions: { date: string; amount: number; txid: string; counterparty: string; }[]; }> async proveOwnership(assetId: string, amount: number, verifier: string): Promise async verifyOwnership(proof: OwnershipProof, useAnyoneKey = false): Promise validateAssetId(assetId: string): boolean async listAssetForSale(assetId: string, amount: number, desiredAssets: Record, description?: string): Promise async findAllAssetsForSale(findMine = false): Promise async makeOffer(entry: MarketplaceEntry, assetId: string, amount: number): Promise async listOutgoingOffers(): Promise async cancelOutgoingOffer(offer: MarketplaceOffer): Promise async listIncomingOffers(forEntry?: MarketplaceEntry): Promise async acceptOffer(offer: MarketplaceOffer): Promise async acknowledgeNewlyAcquiredMarketplaceAssets(): Promise async rejectOffer(offer: MarketplaceOffer): Promise async acknowledgeRejection(offer: MarketplaceOffer): Promise } ```
Class BTMS Details ##### Constructor BTMS constructor. ```ts constructor(confederacyHost = "https://confederacy.babbage.systems", peerServHost = "https://peerserv.babbage.systems", tokensMessageBox = "tokens-box", protocolID = "tokens", basket = "tokens", tokensTopic = "tokens", satoshis = 1000, privateKey?: string, marketplaceMessageBox = "marketplace", marketplaceTopic = "marketplace") ``` Argument Details + **confederacyHost** + The confederacy host URL. + **peerServHost** + The peer service host URL. + **tokensMessageBox** + The message box ID. + **protocolID** + The protocol ID. + **basket** + The asset basket ID. + **tokensTopic** + The topic associated with the asset. + **satoshis** + The number of satoshis involved in transactions. ##### Method findAllAssetsForSale Returns an array of all marketplace entries ```ts async findAllAssetsForSale(findMine = false): Promise ``` Returns An array of all marketplace entries ##### Method getBalance Get the balance of a given asset. ```ts async getBalance(assetId: string, myTokens?: GetTransactionOutputResult[]): Promise ``` Returns Returns a promise that resolves to the balance. Argument Details + **assetId** + The ID of the asset. + **myTokens** + (Optional) An array of token objects owned by the caller. ##### Method getTokens Get all tokens for a given asset. ```ts async getTokens(assetId: string, includeEnvelope = true): Promise ``` Returns Returns a promise that resolves to an array of token objects. Argument Details + **assetId** + The ID of the asset. + **includeEnvelope** + Include the envelope in the result. ##### Method listAssetForSale Lists an asset on the marketplace for sale ```ts async listAssetForSale(assetId: string, amount: number, desiredAssets: Record, description?: string): Promise ``` Returns Overlay network submission results Argument Details + **assetId** + The ID of the asset to list + **amount** + The amount you want to sell + **desiredAssets** + Assets you would desire to have in return so people can make you an offer + **description** + Marketplace listing description ##### Method listIncomingPayments List incoming payments for a given asset. ```ts async listIncomingPayments(assetId: string): Promise ``` Returns Returns a promise that resolves to an array of payment objects. Argument Details + **assetId** + The ID of the asset. ##### Method send Send tokens to a recipient. ```ts async send(assetId: string, recipient: string, sendAmount: number, disablePeerServ = false, onPaymentSent = (payment: TokenForRecipient) => { }): Promise ``` Returns Returns a promise that resolves to a transaction action object. Argument Details + **assetId** + The ID of the asset to be sent. + **recipient** + The recipient's public key. + **sendAmount** + The amount of the asset to be sent. Throws Throws an error if the sender does not have enough tokens. ##### Method validateAssetId Checks that an asset ID is in the correct format ```ts validateAssetId(assetId: string): boolean ``` Returns a boolean indicating asset ID validity Argument Details + **assetId** + Asset ID to validate
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes) --- ## License The license for the code in this repository is the Open BSV License.