chore: self-custody restructuring

pages/service/_meta.json

@@ -1,24 +1,40 @@
 {
+  "--- Beam": {
+    "type": "separator",
+    "title": "Beam"
+  },
   "index": "Getting started",
+  "game": {
+    "title": "Your game"
+  },
+  "sphere": {
+    "title": "Sphere"
+  },
+  "companion": {
+    "title": "Companion"
+  },
+  "reporting": {
+    "title": "Reporting"
+  },
   "--- Self-custody (Beta)": {
     "type": "separator",
     "title": "Self-custody (beta)"
   },
-  "self-custody": {
-    "title": "Getting started"
+  "introduction-self-custody": {
+    "title": "Introduction"
+  },
+  "implement-self-custody": {
+    "title": "Implementation"
   },
   "operations": {
     "title": "Operations (beta)"
   },
   "sessions": {
     "title": "Sessions (beta)"
   },
-  "--- Guides": {
+  "--- Custodial": {
     "type": "separator",
-    "title": "Guides"
-  },
-  "game": {
-    "title": "Managing your game"
+    "title": "Custodial"
   },
   "profiles": {
     "title": "Profiles"
@@ -41,15 +57,6 @@
   "exchange": {
     "title": "Exchange"
   },
-  "companion": {
-    "title": "Companion"
-  },
-  "sphere": {
-    "title": "Sphere"
-  },
-  "reporting": {
-    "title": "Reporting"
-  },
   "--- References": {
     "type": "separator",
     "title": "References"
@@ -63,9 +70,6 @@
     "type": "separator",
     "title": "More"
   },
-  "roadmap": {
-    "title": "Roadmap"
-  },
   "terms-of-service": {
     "title": "Terms of Service"
   },

pages/service/companion.mdx

@@ -0,0 +1,35 @@
+---
+title: Introduction to Beam Companion
+---
+
+import { Callout, Cards, Card } from "nextra/components";
+
+# Introduction to Beam Companion
+
+The Beam Companion app allows users to manage and access their on-chain NFTs earned through playing your game.
+
+You'll be able to find the latest version of the Beam Companion through the following links
+
+<Cards>
+  <Card
+    icon="🍎 "
+    title="iOS"
+    href="https://apps.apple.com/us/app/beam-companion/id6467641736"
+  />
+  <Card
+    icon="🤖 "
+    title="Android"
+    href="https://play.google.com/store/apps/details?id=com.onbeam.companion_app"
+  />
+</Cards>
+
+<Callout emoji="🛠️">
+  Make sure you connect to **Beam testnet** in order to implement the application
+  during your development process. You can switch to testnet by switching on the
+  log-in screen of the app.
+</Callout>
+
+### Connecting users to the Beam Companion app
+
+The Beam Companion app works based on the same authentication solution as is being used in the self-custody features of Beam, meaning that any user you onboard through that solution will automatically be linked to your game and is able to use the Beam Companion app.
+

pages/service/environments.mdx

@@ -14,7 +14,7 @@ Once you are ready to deploy your game to mainnet, simply request the production
 https://api.onbeam.com
 ````
 
-## api keys and environments
+### API keys and environments
 
 <Callout emoji="⚠️">
   Keep in mind that keys are not interchangeable per environment, meaning that you will need to send the correct key in the `x-api-key` header based on the hostname you use.

pages/service/full-api-reference.mdx

@@ -6,6 +6,8 @@ The Beam API is a RESTful API. Given you have obtained your api key, you are abl
 
 If you ever feel the need to access all of the available endpoints directly from our deployed service, you can use the following links
 
+### Custodial API
+
 ```md filename="Swagger UI"
 https://api.testnet.onbeam.com/api/game
 ```
@@ -17,3 +19,18 @@ https://api.testnet.onbeam.com/api/game-json
 ```md filename="OpenAPI specification (YAML)"
 https://api.testnet.onbeam.com/api/game-yaml
 ```
+
+
+### Self-custody API
+
+```md filename="Swagger UI"
+https://api.testnet.onbeam.com/api/self-custody
+```
+
+```md filename="OpenAPI specification (JSON)"
+https://api.testnet.onbeam.com/api/self-custody-json
+```
+
+```md filename="OpenAPI specification (YAML)"
+https://api.testnet.onbeam.com/api/self-custody-yaml
+```

pages/service/implement-self-custody.mdx

@@ -0,0 +1,47 @@
+---
+title: Implementation
+---
+
+import { Cards, Card } from "nextra-theme-docs";
+
+# Implementing Beam
+
+The implementation of our new self-custodial service consists of two components
+
+- The Beam platform client. We currently solely provide a **C# sdk** meant to be implemented in the **Unity**. In the future, we will be releasing more implementations for various platforms.
+- The self-custody client. We currently provide a **C# and Typescript** client.
+
+In the near future, we expect to expand the platfom clients with all the self-custody client methods, giving you more flexibility on how you want to implement Beam in your game.
+
+
+### Initialize the platform client
+
+In order to interact with these clients, you will need a new type of API key - the `Publishable` API key. You will be able to find this API key by regenerating your API keys through the existing API. You can do so programmatically, or by interacting with the method in the [OpenAPI / Swagger UI](https://api.testnet.onbeam.com/api/game#/Game/regenerateApiKeys) interface.
+
+
+```csharp
+
+var beamClient = gameObject.AddComponent<BeamClient>()
+  .SetBeamApiGame("your-game-id", "your-publishable-api-key")
+  .SetEnvironment(BeamEnvironment.Testnet);
+```
+
+
+### The self-custody client
+
+The self-custody client is a new client which can be used to generate [Operations](/service/operations/introduction). Both the self-custody clients we offer for the new self-custodial services, are structured in similar fashion to the existing SDKs that offer custodial [Profiles](/service/profiles/introduction).
+
+Keep in mind that we expect you to also use the `Publishable` API key in these clients.
+
+<Cards>
+  <Card
+    icon="✅ "
+    title="Typescript"
+    href="https://www.npmjs.com/package/@onbeam/self-custody"
+  />
+  <Card
+    icon="✅ "
+    title="C# (RestSharp)"
+    href="https://www.nuget.org/packages/BeamSelfCustody"
+  />
+</Cards>