@eurega/near
v0.0.2
Published
Eurega lib to interact with mintbase & near
Downloads
3
Readme
Explorins near-mintbase API
This library provides a gateway to connect to your mintbase near wallet to your app to get its data and work with it.
- Acquire an API key in the
Developer
tab on Mintbase
working example to connect testnet
First we create an instance to our wallet
import { NearWallet } from '@explorins/near-lib';
const wallet = new NearWallet(
{
MINTBASE_API_KEY,
'testnet'
}
);
Now web can subscribe to wallet logged observable
$logginObservable = wallet.isLogged$;
$logginObservable.subscribe((logged:boolean) => {
...
})
Next we must to init our wallet object
await wallet.init();
After init if we are previously logged, we can recover the loggin state and actuate accordingly in the app
$logginObservable.subscribe((logged:boolean) => {
if(logged) console.log('Already logged in');
})
If you are not connected to your wallet you must link the login button to the following action
// Connect to your mintbase near wallet
await wallet.connect();
(...)
This action will redirect you to your wallet login on the near page
- When we return to our app, we will already be connected to mintbase and we will be able to use its methods
// Connect to your mintbase near wallet
await wallet.mintbaseLogin();
// Retrieve the basic information
const walletDetails = await wallet.getDetails();
const token = await wallet.getTokenFromCurrentWallet();
(...)
The mintbaseLogin function establishes the connection with our mintbase wallet once we have done login in near.
- mintbaseLogin throws us an error in case we are not logged in near , in that case we must capture the error to redirect our users to the login
try {
// Si no está logeado lanzara error y no seguirá
await this.wallet.mintbaseLogin();
} catch (error) {
console.log(' *** not logged, press login button')
}
The wallet object that we have created provides us with an observable that returns information about the login status.
const loggedObservable = wallet.isLogged$;
loggedObservable.subscribe((status: boolean) => {
console.log('Logged status change: ', status);
})
Library errors are returned to the application using numerical codes that allow us to customize our response to the user in each case.
CONNECT: {
USER_NOT_FOUND: '0101',
MINTBASE_LOGIN: '0102',
USUPPORTED_NETWORK: '0103',
MINTBASE_NOT_CONNECTED: '0104',
MINTBASE_ERROR: '0105'
},
DISCONNECT: {
MINTBASE_ERROR: '0201',
MINTBASE_NOT_CONNECTED: '0202',
ALREADY_DISCONNECTED: '0203'
},
TRANSFER_TOKEN: {
ACCOUNT_NOT_FOUND: '0301',
CONTRACT_NOT_FOUND: '0302',
TRANSACTION_FAILS: '0303',
MINTBASE_NOT_CONNECTED: '0304'
},
CONTRACT: {
USER_NOT_FOUND: '0401',
MINTBASE_NOT_CONNECTED: '0402',
MINTBASE_ERROR: '0403',
CONTRACT_NAME_NOT_FOUND: '0404',
NEAR_ERROR: '0405'
},
GET_TOKEN: {
MINTBASE_NOT_CONNECTED: '0501',
TIMEOUT_ERROR: '0502'
},
MAKE_OFFER: {
USER_NOT_FOUND: '0601',
TOKEN_NOT_FOUND: '0602',
STORE_NOT_FOUND: '0603',
MINTBASE_NOT_CONNECTED: '0604',
MINTBASE_ERROR: '0605'
},
FETCH_STORE: {
MINTBASE_NOT_CONNECTED: '0701',
MINTBASE_ERROR: '0702',
GRAPHQL_ERROR: '0703'
},
FETCH_THINGS: {
MINTBASE_NOT_CONNECTED: '0801',
MINTBASE_ERROR: '0802'
},
GET_MINTERS: {
MINTBASE_NOT_CONNECTED: '0901',
MINTBASE_ERROR: '0902',
CONTRACT_ERROR: '0903'
},
FETCH_MARKETPLACE: {
MINTBASE_NOT_CONNECTED: '1001',
MINTBASE_ERROR: '1002'
}