# Setup a Loopring Account
{% hint style="danger" %}
Please update SDK after v3.1.5 and use UnlockAccount with \``` account.publicKey or `generateKeyPair` with `account.publicKey` ``
{% endhint %}
Step 1: Register a wallet address in the Loopring DEX to get an account ID
There are two ways to register an account on the Loopring DEX to get an account ID:
1. via API - Make a deposit to your address by calling the [Loopring exchange address](/resources/common-info/get-exchange-info.md). Once the Loopring exchange receives your deposit (8 confirmations), it will generate an account id for your address.
2. via [Website App](https://loopring.io) - Use an account in Loopring Layer 2 to transfer some tokens to your address, after the transfer is successful, this will generate an account id for the payee address.
Step 2: Retrieve account info using GET Account info by address
Using the newly acquired account id, retrieve the account information using the `getAccount` call.
{% code lineNumbers="true" %}
```ts
const {accInfo} = await LoopringAPI.exchangeAPI.getAccount({
owner: LOOPRING_EXPORTED_ACCOUNT.address,
});
```
{% endcode %}
Step 3: Use keySeed or CUSTOMER_KEY_SEED generateKeyPair
Generate an EdDSA key-pair using ecdsa to sign message. An EdDSA key-pair is needed for making changes to an account in the SDK. You can create a key-seed phrase using the default recommendation or a custom value.
* #### Default `keySeed`
\
Default `keySeed` string format we use looks like the following:
```
Sign this message to access Loopring Exchange: %s with key nonce: %d'.
```
You will need to replace `%s` with the [Loopring exchange address](/resources/common-info/get-exchange-info.md), and replace `%d` with the value of the nonce received in the account information from [step 2](#step-2-retrieve-account-info-using-get-account-info-by-address).
{% code overflow="wrap" lineNumbers="true" %}
```typescript
const keySeed = sdk.BaseAPI.KEY_MESSAGE.replace(
"${exchangeAddress}",
LOOPRING_EXPORTED_ACCOUNT.exchangeAddress
).replace("${nonce}", accInfo.nonce.toString());
const eddsaKey = await sdk.generateKeyPair({
web3,
address: accInfo.owner,
keySeed,
walletType: sdk.ConnectorNames.MetaMask,
chainId: sdk.ChainId.GOERLI,
});
console.log("eddsakey:", eddsaKey.sk);
```
{% endcode %}
* #### Custom keySeed
Custom keySeed string must end with `with key nonce: ${nonce}`\
Example:
```
Sign this message to access ${customString} with key nonce: %d
```
You can define the `customString` yourself, `%d` is the nonce received in the account information from [step 2](#step-2-retrieve-account-info-using-get-account-info-by-address).
{% code overflow="wrap" lineNumbers="true" %}
```typescript
// CUSTOMER_KEY_SEED = "XXXXXX" + " with key nonce: " + "${nonce}";
const keySeed = CUSTOMER_KEY_SEED.replace(
"${nonce}",
accInfo.nonce.toString()
const eddsaKey = await sdk.generateKeyPair({
web3,
address: accInfo.owner,
keySeed,
walletType: sdk.ConnectorNames.MetaMask,
chainId: sdk.ChainId.GOERLI,
});
console.log("eddsakey:", eddsaKey.sk);
```
{% endcode %}
Step 4: Retrieve fees from the exchange get fee
In order to update your account, you'll need to retrieve the list of available fees from the exchange.
Get `updateAccount` fee
{% code overflow="wrap" lineNumbers="true" %}
```typescript
const fee = await LoopringAPI.globalAPI.getActiveFeeInfo({
accountId: accInfo.accountId,
});
console.log("fee:", fee);
```
{% endcode %}
Step 5: updateAccount (activate or reset）
{% code overflow="wrap" lineNumbers="true" %}
```typescript
const result = await LoopringAPI.userAPI.updateAccount({
request: {
exchange: LOOPRING_EXPORTED_ACCOUNT.exchangeAddress,
owner: accInfo.owner,
accountId: accInfo.accountId,
publicKey: {x: eddsaKey.formatedPx, y: eddsaKey.formatedPy},
maxFee: {
tokenId: TOKEN_INFO.tokenMap["LRC"].tokenId,
volume: fee.fees["LRC"].fee ?? "9400000000000000000",
},
keySeed,
validUntil: LOOPRING_EXPORTED_ACCOUNT.validUntil,
nonce: accInfo.nonce as number,
},
web3,
chainId: sdk.ChainId.GOERLI,
walletType: sdk.ConnectorNames.Unknown,
isHWAddr: false,
});
const {accInfo: updateAccountInfo} =
await LoopringAPI.exchangeAPI.getAccount({
owner: LOOPRING_EXPORTED_ACCOUNT.address,
});
console.log(
"updateAccount Result: ",
result,
"updateAccountInfo:",
updateAccountInfo
);
```
{% endcode %}
Step 6: Get account to check update complete
Check that the `publicKey` is the same as the value set in the previous step and frozen is false.
'frozen' will be true until `updateAccount` completes and then it will be set to false.
You can call this API every 10s until `updateAccount` is complete.
{% code overflow="wrap" lineNumbers="true" %}
```typescript
const {accInfo} = await LoopringAPI.exchangeAPI.getAccount({
owner: LOOPRING_EXPORTED_ACCOUNT.address,
});
```
{% endcode %}
Step 7: Retrieve account API key Get apiKey
Get the `apiKey` by eddsa signature and then the `apiKey` can be used to get user assets or to call other APIs
{% code overflow="wrap" lineNumbers="true" %}
```typescript
const apiKey = (
await LoopringAPI.userAPI.getUserApiKey(
{
accountId: accInfo.accountId,
},
eddsaKey.sk
)
).apiKey;
```
{% endcode %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs-protocol.loopring.io/loopring-account/sdk-guides/setup-a-loopring-account.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.