--- updatedAt: 2026-08-18T08:55:53.000Z agentTools: projectIndex: https://docs.onechain.nexus/llms.txt --- # 4-1. Account-Project # 4-1. Account and Project From sign-up to project creation. This is a **one-time setup**. * Console: **What you end up with** * A ONE RAMP account (Google login + 2FA) * A **Studio** — the workspace for your organization * A **Project** and its **Project ID** — later used as `intent.project_id` in the `initialize` request *** ## 4-1.1 Access and Login * Go to → the login screen appears * On your first visit, a **Cookie Notice** appears at the bottom * `Allow Essential Only` — only cookies required for login and security * `Allow All Cookies` — also allows optional cookies * Either choice works; there is no functional restriction ![](https://files.readme.io/5ec9c146ffa2401398acc1501df78414d54b204b54b65fd3b678ae2ef736fb67-01-cookie-notice.png)
* Click `Sign in with Google` → select an account → authenticate * There is no ID/password field and no separate sign-up link — **your first login is the sign-up** ![](https://files.readme.io/ae8fe225cc453c86935aa233e854de218a8a89b72c6a173d9232fc0bfe7a3511-02-login.png)
> This account becomes the Studio **Owner**. Make sure it is a **work account**, not a personal one. *** ## 4-1.2 Sign-up Steps ### ① Start sign-up * A **Sign Up** modal appears → click `Get Started` * `Cancel` — returns to the login screen ### ② Accept the terms * Review the terms, check the agreement items, then continue * Applicable terms → [1.5](https://docs.onechain.nexus/docs/introduce-1#15-links) ### ③ Two-factor authentication (2FA) — **required** * Install an authenticator app — Google Authenticator, Authy, etc. * Scan the QR code, or use `Copy` to copy the secret key and register it manually in the app * Click `Enter Authentication Code` ![](https://files.readme.io/1804e0e267196d6b6ceca82e4dafe64b847823833e997e8729ed70e63e93f3c1-03-2fa-setup.png)
> You cannot complete sign-up without an authenticator app. The secret key and QR code grant direct account access — never share them over messengers or email, and store them only in your company password manager. ### ④ Enter the code → sign-up complete * Enter the 6-digit code from the authenticator app → it is verified automatically * The code rotates every 30 seconds → enter a freshly generated code * `Enter again` — re-enter / `Back to QR Code` — return to the QR step ![](https://files.readme.io/0d309949da98d3bf5ad5889c4bc73bc3d8fe37bbcf13fb195fedc0f0f2bbcfce-04-2fa-code.png)
*** ## 4-1.3 Creating a Studio Right after sign-up you do not belong to any Studio. ![](https://files.readme.io/4ea9e418512c993f597cdf426892f2b09ab239ad141a7daacdfe614e85ad3348-05-studio-empty.png) * The pink `+` — create one yourself * If your team already runs a Studio, **ask an administrator to invite you** > **Recommended: one Studio per team.** A Studio is an organization-level workspace. If several people each create their own, projects and API Keys end up scattered. Have one representative create it and invite the rest. **Fields** | Field | Required | Description | | ----------- | -------- | --------------------------------------------- | | Studio Name | Required | Your organization or team name is recommended | | Studio Logo | Optional | PNG · JPG · JPEG, about 3 MB or less | ![](https://files.readme.io/afaf12b5a7c2cdbd046fe09a392390aac28cba9399015cdc1a65584b7bc7091b-06-create-studio-empty.png) * The `×` at the top right of the logo preview — cancels the upload * Click `Create` ![](https://files.readme.io/b2327559964cb6bbed6fbb7711021e50ff6d7f35cbb93f27c5162f88b4d65244-07-create-studio-filled.png)
**Entering the Studio** * Click the Studio in the list to enter the workspace (the member count is shown under the name) * `+` — create another Studio ![](https://files.readme.io/4e97a32b12a5f6e315a92e1ed6c2c225f9187b08fdba39550972fcb96a509a7c-08-studio-list.png)
*** ## 4-1.4 Creating a Project **Projects** is the default screen when you enter a Studio. Click `New Project` at the top right. ![](https://files.readme.io/15197d65fc38d5d0e9013f0a6e5a4be566563bef6e2fd68dab298bc2185f9932-09-projects-empty.png)
**Studio left menu** * **Projects** — the project list * **Contracts** — contract deployment and management → [4-2. Contracts](https://docs.onechain.nexus/docs/2-contracts) * **Activity Log** — Studio activity history * **API Keys** — issue and manage **MCP API Keys**. This is a **beta feature**. * It lets AI agents access the Studio with predefined permissions and is **unrelated to RAMP integration**. * **As a beta feature, its behavior and screens may change without notice.** * **Settings** — Studio information and member management * **Quick Links** — ONEx Guide · API Reference · TESTNET Faucet · ONEexplorer **Fields** | Field | Required | Description | | ------------ | -------- | ------------------------------------ | | Project Name | Required | **Enter in English** | | Project Icon | Optional | PNG · JPG · JPEG, about 3 MB or less | ![](https://files.readme.io/7fc1ed1ed358a4632372e54095b197077cf6a5028a51b4ac526d63d54e30caad-10-create-project-empty.png)
> **Caution** Pressing `Esc` closes the modal without saving and clears your input. When closing a dropdown, click outside it instead of pressing `Esc`. To cancel, use `Cancel` or `×`. ![](https://files.readme.io/a6989dd7bd1dd98d25d83be380c72494aed9a437450a5aeefb08e187b3885b14-13-create-project-filled.png)
*** ## 4-1.5 Confirming Creation and the Project ID The list shows the icon, name, **Project ID**, and creation date. ![](https://files.readme.io/f531dbe01b4f5d7ba3643858c763ec5a1c031a2e692041b78f2c5a38aa693591-14-projects-list.png)
* The icon at the top right toggles list/card view; the search box at the top searches by name ### Project ID * A **32-character hexadecimal** value (for example `c1274a…30b3`). * It is **issued automatically** when the project is created and **cannot be changed**. * Where to find it — the `Projects` list, and project `Settings` → `General` * **This is the value you put in **`intent.project_id`** in the **`initialize`** request.** → [5.3](https://docs.onechain.nexus/docs/endpint-apis#53-issuing-a-uuid--initialize) ### Editing the name and icon * Change them in project `Settings` → `General` (`Basic Information`). * Changes are saved only after you click `Update Project`. ![](https://files.readme.io/d49ee974e721f74cf300dfb9873ccd2ffb587ef4c9f1002516ba909668886632-16-project-basic-info.png)
> Do not expose the Project ID in public repositories or front-end code. *** ## 4-1.6 Dashboard (Operations View) Clicking a project opens the dashboard. This is the screen for operational metrics after launch. ![](https://files.readme.io/d6f4c90a814f0fff21c2ee4f14a00161c5063b978455cd1954a1929b52ac2ba1-15-project-dashboard.png)
* **Mainnet / Testnet** switch and date range selection * Metrics — **Mint Amount · Burn Amount · Net Amount · Orders · Success Rate** * **Token Breakdown** at the bottom — per-token activity for the period **Project left menu** * **ONEramp** — Settings (Ramp settings) → [4-3](https://docs.onechain.nexus/docs/3-ramp-settings#4-3-ramp-settings) · Logs (processing logs) * **Tokens** — Linked Contracts (linked token contracts) * **Settings** — General (basic information) → [4-1.5](https://docs.onechain.nexus/docs/account-project#4-15-confirming-creation-and-the-project-id) · Blacklist (blocked addresses) → [4-1.7](https://docs.onechain.nexus/docs/account-project#4-17-blacklist--managing-blocked-addresses) * **All Projects** — return to the project list ### Post-launch operational checks Screens to monitor while running in production. | Location | Screen | Purpose | | -------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | Project | **Dashboard** | Mint Amount · Burn Amount · Net Amount · Orders · **Success Rate** · Token Breakdown | | Project | **ONEramp → Logs** | On/off-ramp processing logs | | Project | **Tokens → Linked Contracts** | Status of linked token contracts | | Project | **Settings → Blacklist** | Managing blocked addresses → [4-1.7](https://docs.onechain.nexus/docs/account-project#4-17-blacklist--managing-blocked-addresses) | | Studio | **Activity Log** | Studio activity history (tracks configuration changes) | **Regular checks** * **Success Rate** dropping — a sign of increasing failed transactions. Check `Logs` for the cause. * **Asset restoration logs** — a rising count means transaction failures or a flaw in your validation logic * **Issuance limit consumption** — remaining headroom against `Max Supply` and the per-period limit * Retain **audit logs** on your server (`uuid`, `tx_hash`, `receipt.status`) → [5.6](https://docs.onechain.nexus/docs/endpint-apis#56-result-webhook--handle-order-result) * **Assign an owner and a review cadence** for operational monitoring. *** ## 4-1.7 Blacklist — Managing Blocked Addresses Register abusive wallet addresses to **block all RAMP token-related actions** for them.
`(Blocking a wallet across other NEXUS services on the ONE Chain network requires a separate request.)` **Path** — Project `Settings` → `Blacklist` ![](https://files.readme.io/7f15d5cce040e295eda09da0197049d0063ba6d9e9360319d1ff534c2087303f-39-blacklist.png)
* Use the **Mainnet / Testnet** switch at the top right to manage the block list per network. * If no addresses are registered, the list appears empty. * **Search** — look up by wallet address. ### Registering an address Click `Register` to open the registration modal. ![](https://files.readme.io/8cda13b7e628410b072ae596729f00cd5df93d494f529c6832ee75f6b1b40f34-40-blacklist-register.png)
| Field | Required | Description | | ------------------ | -------- | ---------------------------------------------- | | **Wallet Address** | Required | The wallet address to block (`0x…`) | | **Reason** | Required | Why it is blocked. Multi-line input is allowed | * Fill in both fields, then click `Register`. * **The reason is required.** Write something specific so the rationale survives a change of staff (for example: asset duplication attempt, or the timestamps and counts of abnormal repeated requests). > **The lists are separate per network.** An address blocked on Testnet is not blocked on Mainnet. For a production response, always confirm that you registered it **on the Mainnet tab**. *** ## 4-1.8 Inviting Members Studio `Settings` → `Members` tab ![](https://files.readme.io/c7755951678c2d77b3b2689db585a76530356762373e50c28e526fdc70601945-17-studio-members.png)
* `Invite Member` — invite a member * Columns — name · email · **Role** · Last Login · Status * The Studio creator has the **Owner** role * **Only admin and owner can remove members** *** *In the screenshots, the 2FA secret key, Project ID, and account email are masked for security.* ## 4-1.9 FAQ **There is no sign-up link in the console.** That is expected. Only Google login is supported, and your first login is the sign-up. **My 2FA code keeps being rejected.** Set your phone's clock to automatic (network time), and enter a code right after it is generated. **I lost the device with my authenticator app.** Contact to request a 2FA reset. **My input in the Create Project modal disappeared.** Pressing `Esc` closes the modal without saving and clears it. Reopen it and enter the values again.