Skip to content

Commit 86ab64f

Browse files
authored
Merge pull request #316 from NillionNetwork/feat/nilpay_evm
feat/nilpay_evm
2 parents 837ccff + 7f6084f commit 86ab64f

File tree

70 files changed

+144
-346
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

70 files changed

+144
-346
lines changed

blog/2025-10-01-understanding-nildb-encryption.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "How nilDB stores encrypted fields using secret sharing with %share
44
slug: nildb-encryption
55
authors: nillion-team
66
tags: [nilDB, encryption, secret-sharing]
7-
image: /img/articles/nildb_diagram.png
7+
image: /img/articles/nildb-diagram.png
88
hide_table_of_contents: false
99
---
1010

docs/blacklight/verify/register-apps.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Blacklight currently verifies workloads running on:
1212
- **nilCC** (Nillion's Confidential Compute) - Nillion's TEE compute infrastructure
1313
- **Phala Network** - Phala TEE workloads registered with Blacklight
1414

15-
### Pre-requisite
15+
### Prerequisite
1616

1717
- Basic knowledge of Docker
1818

@@ -228,7 +228,7 @@ curl https://YOUR-ENDPOINT.phala.network/api/attestation
228228

229229
<div style={{maxWidth: '500px'}}>
230230

231-
![Phala Workload](/img/phala_workload.png)
231+
![Phala Workload](/img/phala-workload.png)
232232

233233
</div>
234234

docs/blind-computer/build/compute/verification.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ An attestation report is provided by the trusted execution environment (TEE) wit
1414
2. Understanding of Docker and Git.
1515

1616
### Usage
17-
![nilcc verify first step](/img/verify_first_step.png)
17+
![nilcc verify first step](/img/verify-first-step.png)
1818

1919
1. Visit the nilCC [Workload Manager](https://nilcc.nillion.com/verify).
2020
2. You can either use a precomputed measurement hash of your workload or compute it locally yourself.
@@ -49,7 +49,7 @@ The main difference between `precompute` and `local` measurement hash is that th
4949
---
5050
### Badge Embedding (Optional)
5151

52-
![nilcc verify badge](/img/verify_badge.png)
52+
![nilcc verify badge](/img/verify-badge.png)
5353

5454
#### Prerequsities
5555

@@ -87,10 +87,10 @@ git push origin v0.1.1
8787

8888
Increment the versioning to your preference. Then you GH Action should run and then make a PR request with the latest `verification-manifest.json`
8989

90-
![nilcc GH Action badge](/img/GH_action.png)
90+
![nilcc GH Action badge](/img/gh-action.png)
9191
GH Action
9292

93-
![nilcc verify badge](/img/verify_manifest_PR.png)
93+
![nilcc verify badge](/img/verify-manifest-PR.png)
9494
Verify PR that was auto-created by the GH Action Bot.
9595

9696
We can now add your public `verification-manifest.json` from your Github Repo to the `Github URL` input box. You will receive a `React/JSX` Code Snippet to use on your site.

docs/blind-computer/build/network-api-access.mdx

Lines changed: 27 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -3,76 +3,70 @@ import TabItem from '@theme/TabItem';
33

44
# Network API Access
55

6-
nilPay allows you to subscribe and create credentials for using the [Private Storage](/blind-computer/build/storage/overview) and [Private LLMs](/blind-computer/build/llms/overview) network APIs.
6+
The nilPay Subscription Portal allows you to subscribe and create credentials for using the [Private Storage](/blind-computer/build/storage/overview) and [Private LLMs](/blind-computer/build/llms/overview) network APIs.
77

88
This guide walks you through the process of creating an API key.
99

10-
<iframe
10+
{/* <iframe
1111
width='100%'
1212
height='500'
1313
src='https://www.youtube.com/embed/F1pWAUV78rg'
1414
title='YouTube video player'
1515
frameborder='0'
1616
allow='accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture'
1717
allowfullscreen
18-
></iframe>
18+
></iframe> */}
1919

20-
## Create an API Key
2120

22-
In order to get an API Key, you must have a nillion address. We recommend starting by following the [wallet setup guide](/community/guides/nillion-wallet) to get started.
21+
## Prerequisites
22+
You must have acquired some Sepolia ETH + NIL via this [faucet guide.](/community/guides/testnet-faucet)
2323

24-
Use the [nilPay Subscription Portal](https://subscription.nillion.com) to create an API key.
24+
## Create an API Key
2525

26-
Ensure you have an EVM browser wallet (i.e. Metamask) + a Cosmos based walled (i.e. Keplr)
26+
Open up the [nilPay Subscription Portal](https://subscription.nillion.com) to create an API key. Sign in via your desired EVM browser wallet.
2727

2828
![nilPay Page](/img/nilpay-main-page.png)
2929

30+
## Connecting to Sepolia
31+
Your EVM wallet should connect to the nilPay Portal. Select `Sepolia` for your desired network.
32+
33+
![nilPay Page](/img/nilpay-identity.png)
34+
3035
## Identity Options
3136

32-
For those that may have used the previous nilPay Portal, here is more context regarding the `did:nil` and `did:eth` formats.
37+
<center><img src="/img/nilpay-identity-explainer.png" alt="nilPay Choose Recipient" style={{width: '60%'}} /></center>
38+
39+
The **Choose Recipient** step lets you decide which identity will have access to your nilDB and/or nilAI subscription. There are two categories:
3340

34-
A DID (Decentralized Identifier) is an unique cryptographic identifier for builders, users, and nodes. Format: `did:nil:[66-character-hex-string]`. Derived from public keys for verifiable authentication.
41+
| Category | Options | How it works |
42+
|---|---|---|
43+
| **Wallet-based** | My Wallet, Another Identity | Access is tied directly to an Ethereum address. Use **My Wallet** for your connected address, or **Another Identity** to grant access to a different Ethereum address. |
44+
| **Key-based** | Generate New Identity, Import Secret Key | Works like a standard API key approach — a Secp256k1 private key authenticates your requests directly. Use **Generate New Identity** to create a new key, or **Import Secret Key** to reuse an existing one. The key is associated with your Ethereum address at creation time. |
3545

36-
If you are using an Ethereum wallet, this also maps to the `did:eth` format.
46+
:::note
47+
Your address may appear as `did:ethr:0xXXX`. This is a DID (Decentralized Identifier) — a unique cryptographic identifier derived from your public key, used for verifiable authentication.
48+
:::
3749

3850
<Tabs>
3951
<TabItem value='nilDB' label='Private Storage' default>
4052

41-
![nilPay Payment Types](/img/nilpay-payment-types.png)
42-
43-
For nilDB, you can use all of these options to pay for the subscription.
44-
- If you want an Ethereum wallet to be the authority for your keys you can use the `Brower Wallet` option.
45-
- Otherwise if you prefer to be key based, you may import one of your older keys via `Use Secret Key` or `Generate New Key` to create a new one.
46-
47-
If using the Browser Wallet option, you have two options:
48-
1. Pay for yourself which is recommended if you are the developer of the application.
49-
2. Paying for others which is recommended if you are subscribing on behalf of someone else .
53+
For nilDB, all four identity options are available — both wallet-based and key-based.
5054

5155
</TabItem>
5256

5357
<TabItem value='nilAI' label='Private LLM' default>
5458

55-
![nilPay Payment Types](/img/nilpay-payment-ai-flow.png)
56-
57-
For nilAI, you can either use the `Use Secret Key` or `Generate New Key` option for now.
58-
59-
Also ensure to mark the `Create legacy did:nil (for backwards compatibility). This must be selected for nilAI` checkbox for backwards compatibility.
59+
For nilAI, only key-based options are supported: **Generate New Identity** or **Import Secret Key**. This works like a standard API key approach — your secret key authenticates requests directly. Do not lose your Secret Key.
6060

6161
</TabItem>
6262
</Tabs>
6363

6464
## Subscription to nilAI and/or nilDB
6565

66-
In order to subscribe to a nillion service, you must have a subscription. This is possible by using a set amount of uNIL tokens.
66+
You have the required NIL from the [prerequisite](#prerequisite) / [testnet faucet](https://faucet.testnet.nillion.network/), so you should be able to subscribe to either of the services.
6767

68-
This is currently for testnet, therefore you can get free NIL from the [testnet faucet.](https://faucet.testnet.nillion.com/) We also have a testnet faucet [guide](/community/guides/testnet-faucet) to help you get started.
69-
70-
Click on the either the **Subscribe to nilAI** or **Subscribe to nilDB** button to subscribe and follow the wallet prompts.
68+
Click on the either `Purchase` for `nilDB` or `nilAI` to subscribe and follow the wallet prompts.
7169

7270
After the payment goes through, you will have a 28 day subscription to the service and can now use your keys.
7371

74-
![nilAI Subscription](/img/nildb_subscription.png)
75-
76-
This is possible for both services by following the same steps.
77-
78-
![nilDB payment](/img/nilpay_bothservice_subscription.png)
72+
<center><img src="/img/nilpay-successful-payment.png" alt="nilPay Successful Subscription" style={{width: '60%'}} /></center>

docs/blind-computer/build/network-config.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -22,13 +22,12 @@ nilCC OpenAPI Spec: https://api.nilcc.nillion.network/openapi.json
2222

2323
<Tabs>
2424
<TabItem value="nilDB-testnet" label="nilDB Testnet" default>
25-
25+
26+
### [nilauth-stg](https://nilauth-1bc3.nillion.network/about)
2627
```
27-
NILCHAIN_URL=http://rpc.testnet.nilchain-rpc-proxy.nilogy.xyz
28-
NILAUTH_URL=https://nilauth.sandbox.app-cluster.sandbox.nilogy.xyz
29-
NILAUTH_PUBLIC_KEY=03e3ba1eb887b4e972fbf395d479ff6cdb2cec91ba477ffc287b2b9cb5ec2161aa
28+
NILAUTH_URL=https://nilauth-1bc3.staging.nillion.network
29+
NILAUTH_PUBLIC_KEY=02188ca67e3410e31ca2d2562059d7d8cfec29c5fe1d0e52a1ee4b003648f01bc3
3030
```
31-
### Nodes
3231

3332
### [nildb-stg-n1](https://nildb-stg-n1.nillion.network/about)
3433

@@ -54,13 +53,11 @@ nilCC OpenAPI Spec: https://api.nilcc.nillion.network/openapi.json
5453
</TabItem>
5554

5655
<TabItem value="nilDB-mainnet" label="nilDB Mainnet">
57-
56+
### [nilauth](https://nilauth-eb42.nillion.network/about)
5857
```
59-
NILCHAIN_URL=http://nilchain-rpc.nillion.network
60-
NILAUTH_URL=https://nilauth-cf7f.nillion.network
61-
NILAUTH_PUBLIC_KEY=020b419e17d0d11445ea46520086952772eb18f5cb9f949c0ad0b418282617cf7f
58+
NILAUTH_URL=https://nilauth-eb42.nillion.network
59+
NILAUTH_PUBLIC_KEY=03658600f1c0876067c66488f962e7f0ad611bdb0c9446e05f000d7bfc2b09eb42
6260
```
63-
### Nodes
6461

6562
### [nildb-5ab1](https://nildb-5ab1.nillion.network/about)
6663

@@ -127,6 +124,14 @@ nilCC OpenAPI Spec: https://api.nilcc.nillion.network/openapi.json
127124
API docs: https://nilai-f910.nillion.network/docs
128125
Models: openai/gpt-oss-20b
129126
```
127+
128+
### [nilai](https://api.nilai.nillion.network/docs)
129+
130+
```
131+
nilAI Node URL: https://api.nilai.nillion.network
132+
API docs: https://api.nilai.nillion.network/docs
133+
Models: openai/gpt-oss-20b
134+
```
130135

131136
</TabItem>
132137

docs/blind-computer/build/storage/collection-explorer.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ import CTABanner from '@site/src/components/CTABanner';
22

33
# Collection Explorer
44

5-
[![Collection Explorer](/img/collection_explorer/collection_explorer_card.png)](https://collection-explorer.nillion.com/)
5+
[![Collection Explorer](/img/collection-explorer/collection-explorer-card.png)](https://collection-explorer.nillion.com/)
66

77
The [Nillion Collection Explorer](https://collection-explorer.nillion.com) is a no-code builder tool for creating and managing Nillion Private Storage schemas, collections, and records. This web-based interface provides a UI abstraction that speeds up and simplifies development by allowing builders to interact with Nillion's private data storage infrastructure without requiring programming knowledge or command-line tools. Everything possible through the Collection Explorer is also available programmatically via the Nillion [Secretvaults SDK](/blind-computer/build/storage/secretvaults).
88

@@ -39,7 +39,7 @@ Once you have a Nillion API Key with an active nilDB subscription, go to the [Co
3939
3. Enter your [Nillion API Key](/blind-computer/build/network-api-access) for authenticated access
4040
4. Save your configuration - these settings will persist across Collection Explorer sessions
4141

42-
[![Set API Key](/img/collection_explorer/collection_explorer_set_nillion_api_key.png)](https://collection-explorer.nillion.com/)
42+
[![Set API Key](/img/collection-explorer/collection-explorer-set-nillion-api-key.png)](https://collection-explorer.nillion.com/)
4343

4444
## Managing Collections
4545

@@ -52,7 +52,7 @@ The Collections dashboard provides an overview of all collections where your bui
5252
- View key metrics like record count and creation timestamps
5353
- See collection types (standard or owned)
5454

55-
[![View Collections](/img/collection_explorer/collection_explorer_view_collections.png)](https://collection-explorer.nillion.com/collections)
55+
[![View Collections](/img/collection-explorer/collection-explorer-view-collections.png)](https://collection-explorer.nillion.com/collections)
5656

5757
### Create New Collections
5858

@@ -69,7 +69,7 @@ The custom schema builder provides an intuitive, visual interface:
6969
- **Live preview**: See your JSON Schema update in real-time as you build
7070
- **Schema validation**: Automatic validation ensures your schema is properly formatted
7171

72-
[![Create Collection with the UI](/img/collection_explorer/collection_explorer_create_collection_ui.png)](https://collection-explorer.nillion.com/)
72+
[![Create Collection with the UI](/img/collection-explorer/collection-explorer-create-collection-ui.png)](https://collection-explorer.nillion.com/)
7373

7474
#### Option 2: JSON Schema Upload (for devs with existing JSON schema code)
7575

@@ -80,15 +80,15 @@ If you already have a JSON Schema or prefer working with code:
8080
- **Error feedback**: Get immediate feedback on any schema formatting issues
8181
- **Faster setup**: Skip the visual builder if you're comfortable with JSON
8282

83-
[![Create Collection by uploading json](/img/collection_explorer/collection_explorer_create_collection_json.png)](https://collection-explorer.nillion.com/)
83+
[![Create Collection by uploading json](/img/collection-explorer/collection-explorer-create-collection-json.png)](https://collection-explorer.nillion.com/)
8484

8585
## Working with Records and Schemas
8686

8787
### Managing Collection Records
8888

8989
Once you have a collection, you can fully manage its data:
9090

91-
[![View Records](/img/collection_explorer/collection_explorer_records.png)](https://collection-explorer.nillion.com/)
91+
[![View Records](/img/collection-explorer/collection-explorer-records.png)](https://collection-explorer.nillion.com/)
9292

9393
**Collection Overview:**
9494

@@ -112,7 +112,7 @@ Once you have a collection, you can fully manage its data:
112112

113113
Understanding and modifying your collection's structure:
114114

115-
[![View Collection Schema](/img/collection_explorer/collection_explorer_view_schema.png)](https://collection-explorer.nillion.com/)
115+
[![View Collection Schema](/img/collection-explorer/collection-explorer-view-schema.png)](https://collection-explorer.nillion.com/)
116116

117117
- **Schema visualization**: See the complete JSON Schema that defines your collection's structure and validation rules
118118
- **Copy functionality**: Easily copy schema JSON for use in other applications or for backup

docs/blind-computer/build/storage/quickstart.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ You will need an Ethereum and Cosmos wallet (i.e., MetaMask and Keplr) to get yo
4848

4949
1. Switch to the `Testnet` network
5050
2. Connect your developer MetaMask and Keplr wallets
51-
3. [Fund your account with Testnet NIL](https://faucet.testnet.nillion.com)
51+
3. [Fund your account with Testnet NIL](https://faucet.testnet.nillion.network)
5252
4. Subscribe to `nilDB` using your subscription wallet
5353

5454
## 2. Project Setup

docs/blind-computer/build/storage/ts-docs.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,8 @@ SecretVaults SDK [SecretVaultBuilderClient](https://nillion.pub/secretvaults-ts/
2525

2626
Before building with the SecretVaults SDK, you need:
2727

28-
1. Nillion Wallet: [Create a wallet](/community/guides/nillion-wallet)
28+
1. EVM Wallet
29+
2. Sepolia ETH
2930
2. Testnet NIL: Get NIL tokens from the [Nillion faucet](/community/guides/testnet-faucet)
3031
3. Get a [Nillion API Key](/blind-computer/build/network-api-access) with a subscription to nilDB
3132

docs/blind-computer/tools.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,9 @@ import ToolFeatureItem from '@site/src/components/ToolFeatureItem';
1313

1414
<ToolFeatureItem
1515
title="NIL Faucet"
16-
description="Get NIL (nilChain Testnet tokens) to start building apps."
16+
description="Get NIL (Nillion Testnet tokens) to start building apps."
1717
icon="💧"
18-
href="https://faucet.testnet.nillion.com"
18+
href="https://faucet.testnet.nillion.network/"
1919
external={true}
2020
guideHref="/community/guides/testnet-faucet"
2121
guideExternal={false}
@@ -25,7 +25,7 @@ import ToolFeatureItem from '@site/src/components/ToolFeatureItem';
2525
title="nilPay Subscription Platform"
2626
description="Pay NIL to get a Nillion API Key and subscribe to nilDB (Private Storage) or nilAI (Private LLMs) services."
2727
icon="🔑"
28-
href="https://nilpay.vercel.app/"
28+
href="https://subscription.nillion.com/"
2929
external={true}
3030
guideHref="/blind-computer/build/network-api-access"
3131
guideExternal={false}

docs/blind-computer/tools/ai-assisted-workflow.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,6 @@ The [Nillion Builder Guide LLM](https://chatgpt.com/g/g-687e6e6b52508191bb1537b4
2020
/>
2121

2222
## llm.txt
23-
\\
2423
Our `llm.txt` file contains comprehensive information about Nillion's architecture, developer tools, and integration guides. AI assistants can use this to understand:
2524

2625
- Core concepts like Blind Computation and Blind Modules

0 commit comments

Comments
 (0)