Merge pull request #78 from ten-protocol/0xjba-patch-3

Update and rename gateway-widget.md to programmable-gateway.md

Author: 0xjba

docs/tools-infrastructure/gateway-widget.md

@@ -0,0 +1,116 @@
+---
+sidebar_position: 4
+---
+
+# Programmable Access to Gateway
+
+# TEN Network Gateway API
+
+Base URL: `https://testnet.ten.xyz`
+
+## 1. Get Encryption Token
+
+**Endpoint:** `GET /v1/join`
+
+Generates and returns an EncryptionToken.
+
+```bash
+curl -X GET https://testnet.ten.xyz/v1/join
+```
+
+```javascript
+const response = await fetch('https://testnet.ten.xyz/v1/join');
+const token = await response.text();
+```
+
+## 2. Get Message to Sign
+
+**Endpoint:** `POST /v1/getmessage`
+
+Generates and returns a message (if needed 712 typed message too) for the user to sign based on the provided encryption token.
+
+```bash
+curl -X POST "https://testnet.ten.xyz/v1/getmessage/" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "encryptionToken": "$EncryptionToken",
+    "formats": ["EIP712"]
+  }'
+```
+
+```javascript
+const msgRes = await fetch('https://testnet.ten.xyz/v1/getmessage/', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    encryptionToken: token,
+    formats: ['EIP712'],
+  }),
+});
+const data = await msgRes.json();
+```
+
+## 3. Authenticate User
+
+**Endpoint:** `POST /v1/authenticate?token=$EncryptionToken`
+
+Submits a signed message in the format address & signature, proving ownership of the private keys for the account, and links that account with the encryption token.
+
+```bash
+curl -X POST "https://testnet.ten.xyz/v1/authenticate/?token=$EncryptionToken" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "address": "$Address",
+    "signature": "$Signature"
+  }'
+```
+
+```javascript
+await fetch(`https://testnet.ten.xyz/v1/authenticate/?token=${EncryptionToken}`, {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    address,
+    signature: sig
+  }),
+});
+```
+
+## 4. Query Address Registration
+
+**Endpoint:** `GET /v1/query/address?token=$EncryptionToken&a=$Address`
+
+Returns a JSON response indicating whether the address "a" is registered for the user.
+
+```bash
+curl -X GET "https://testnet.ten.xyz/v1/query/address?token=$EncryptionToken&a=$Address"
+```
+
+```javascript
+const response = await fetch(`https://testnet.ten.xyz/v1/query/address?token=${token}&a=${address}`);
+const data = await response.text();
+```
+
+## 5. Revoke Access
+
+**Endpoint:** `POST /v1/revoke?token=$EncryptionToken`
+
+Deletes encryption token associated with the account.
+
+```bash
+curl -X POST "https://testnet.ten.xyz/v1/revoke?token=abc123"
+```
+
+```javascript
+await fetch(`https://testnet.ten.xyz/v1/revoke?token=${token}`, {
+  method: 'POST'
+});
+```
+
+## RPC Usage
+
+After authentication, use the encryption token with RPC calls:
+
+```
+https://testnet.ten.xyz/v1/?token=<EncryptionToken>
+```

docs/tools-infrastructure/programmable-gateway.md

@@ -14,7 +14,7 @@ Keep in mind that you will not be able to query data on accounts that have not b
 You need to follow the following steps:
 
 1. Change the functions of your smart contracts according to the instructions given [here](/docs/getting-started/for-developers/explore-contracts-in-ten).
-2. Integrate TEN Gateway into your dApp using the instructions provided [here](/docs/tools-infrastructure/gateway-widget).
+2. Integrate TEN Gateway into your dApp.
 3. Deploy your SCs into TEN using [compatible tools](/docs/tools-infrastructure/compatible-tools) (e.g. Truffle Suite).
 4. Invite your users to learn more about encryption!