Quick Start

​
Installation
The SDK is available as a NPM package. Install using
yarn add @charged-particles/sdk
​
npm install @charged-particles/sdk
Getting started
// Node
import Charged from '@charged-particles/sdk'
​
// Creating a signer. This is optional, used for making transactions.
const wallet = ethers.wallet.fromMnemonic(seedPhrase);
​
// Multiple providers array
const mySpecialProviders = [
	{
		network: 1,
		service: { 
			'alchemy': 'apiKey',
		},
	},
	{
		network: 42,
		service: {
			'rpcUrl': '<https://eth-kovan.alchemyapi.io/v2/><key>'
		}
	}
];
const charged = new Charged({providers: mySpecialProviders, signer: wallet});
​
// Ethers
const ethersProvider = ethers.getDefaultProvider();
const charged = new Charged({providers: ethersProvider, signer: wallet});
​
// Web3
var web3 = new Web3('<http://localhost:8545>');
const charged = new Charged({providers: ethersProvider, signer: wallet});
// Web
import Charged from '@charged-particles/sdk'
​
const charged = new Charged({providers: window.ethereum});
Be careful not to keep your secrets, or private key in clear text !
Configuration
Charged class object constructor config parameter.
{
	sdk: { 
		// checks that signer network matches respective contract
		NftBridgeCheck: false 
	},
	transactionOverride: { 
		from: ''
		value: '' 
		gasPrice: '' 
		gasLimit: ''
		blockTag: ''
		nonce:  ''
	}
}
Interacting with the protocol
When reading and/or writing you will need to define which NFT you are working with.
/*
Before you call any functions on a specific particle, you'll need to specify 
which one you are going to work with.
*/
​
const contractAddress = '0x1234';
const tokenId = 33;
​
const nft = charged.NFT(contractAddress, tokenId);
​
// This energizes our nft with 47 DAI tokens.
const txReciept = await nft.energize(
    'aave.B',
    '0xDAI',
    ethers.utils.parseEther('47')
);
​
// Get the energized mass
const massBN = await nft.getMass('aave.B', '0xDAI');
​
// Discharges all of the interest accrued by the DAI tokens to my wallet.
const txReceipt2 = await nft.discharge('0xMYADDRESS', 'aave.B', '0xDAI');
Utilities
The SDK provides a set of utility functions. The example below shows the format that all the functions are called by.
// This will fetch the addresses of a contract associated with the main contract
const stateAddress = await charged.utils.getStateAddress()

Common Terminology

Next - SDK

API

Last modified 3mo ago

Copy link

On this page

Installation

Getting started

Configuration

Interacting with the protocol

Utilities