Login
This function should be called whenever a new Auth token is issued to the user when they first log in, when a refreshed token is issued, or if the user is switched. This Auth token will be authenticated via a webhook endpoint that you will provide, and only once validated can the user access their wallet.
async Login(userIdentifier, token, apiKey, secretKey)Parameter | Type | Definition |
|---|---|---|
userIdentifier | String | The unique user ID for the current player.
Please ensure that this userIdentifier matches the value returned by your verification endpoint. |
token | String | The encoded Auth token issued to the user. |
apiKey | String | |
secretKey | String |
{
"statusCode": 1/0,
"data": {
"userIdentifier": "userIdentifier", // the userIdentifier returned from your JWT verification endpoint
"chainWallets": [
"eth": [
"address" // list of addresses for each chain
],
...
], // list of wallet addresses for each chain
"assets": [
"eth_eth": { // assetKey
"totalBalance": "totalBalance", // total balance in BigNumber, across all user accounts
"accountBalances": [
{
"address": "address", // wallet address
"balance": "balance" // balance in BigNumber
},
]
},
...
], // list of assets owned by user
"collectibles": [
{
/****** Metafi Asset fields *******/
"symbol": "",
"chain": {
/* Metafi chain Object */
},
"decimals": 0,
"isNative": false,
"contractAddress": "contractAddress",
"assetKey": "",
"className": "Asset",
"tokenStandard": {
"name": "erc1155"
},
/****** NFT specific fields *******/
"name": "name", // name extracted from NFT metadata
"image": "imageURL", // image URL extracted from NFT metadata
"description": "description", // description extracted from NFT metadata
"tokenUri": "tokenUri", // fetched from smart contract
"metadata": { // raw NFT metadata extracted from token URI
"name": "name",
"description": "description",
"image": "imageURL",
},
"tokenId": "tokenId" // fetched from smart contract
},
...
],
}
"error": "error" // error if any
}
You can update your Auth Token verification URL on the Developer Portal under the Project Settings menu.
When the Login function is invoked, we will invoke the configured Auth Token verification URL with the token passed to us in the Login function in the body. The response must be the userIdentifier of the user to which you want the user's wallet to be linked to.
The endpoint must implement the following format:
post
https://your-webhook-url
/path
1
import { Login } from '@metafi/metafi-js-package';
2
import { getLoginToken } from './controllers/login'
3
4
function App() {
5
6
const handleLogin = async () => {
7
var email = "[email protected]";
8
var jwtToken = getLoginToken(email); // your logic to login user
9
10
var result = await Login(
11
email,
12
jwtToken,
13
"YOUR-API-KEY",
14
"YOUR-SECRET-KEY"
15
);
16
17
console.log("Login results", result);
18
}
19
20
return (
21
<div>
22
<button onClick={handleLogin}>Handle login</button>
23
</div>
24
);
25
}
26
27
export default App;
28
Last modified 2mo ago