Unity SDK docs, phase 1

docs/unity.md

@@ -0,0 +1,55 @@
+---
+title: Tezos SDK for Unity
+authors: Tim McMackin
+last_update:
+  date: 22 December 2023
+---
+
+The Tezos SDK for Unity provides tools that let you access user wallets and Tezos in games and other Unity projects.
+You can use Tezos via the SDK to:
+
+- Use a player's Tezos account as their account for a game and their wallet as their way of logging in to the game
+- Accept payments from players in tez
+- Use Tezos to create game assets, store player inventories, and transfer assets between players
+- Verify that users own specific game assets and allow them to sell or share them to other players
+- Use Tezos smart contracts as backend logic for games
+
+## Installation and use
+
+For a walkthrough of installing and using the SDK in an existing Unity project, see [Quickstart](./unity/quickstart).
+
+## Tutorial scenes
+
+The SDK includes tutorial scenes that demonstrate how to use the SDK.
+For information about setting up and using the scenes, see [Tutorial scenes](./unity/scenes).
+
+## SDK objects
+
+The SDK provides these objects:
+
+- [`DAppMetadata`](./unity/reference/DAppMetadata): Read-only metadata about the project, including the Name, Url, Icon, and Description fields that you set on the TezosManager prefab in the Unity Editor.
+
+- [`Wallet`](./unity/reference/Wallet): An object that provides information about the connected wallet and allows you to send transactions from the user's account.
+
+- [`EventManager`](./unity/reference/EventManager): An object that provides events that you can add listeners to.
+You can see these events and their return values in the `WalletEventManager.cs` file.
+
+- [`TezosConfig`](./unity/reference/TezosConfig): An object that sets the [RPC](../architecture/rpc) node that the SDK uses to send transactions to Tezos
+
+- [`TokenContract`](./unity/reference/TokenContract): An object that provides an FA2 contract and convenience methods to access it.
+You can use this object to deploy the contract and call the contract's entrypoints to create and transfer tokens.
+
+- [`API`](./unity/reference/API): An object that provides methods to access data from Tezos, such as an account's balance in tez or the metadata for a token.
+
+## Dependencies
+
+The Tezos SDK uses modified versions of the following libraries for communication:
+
+- **Airgap Beacon SDK**: Interacts with Tezos wallets through the Beacon standard for iOS, Android, and WebGL platforms.
+- **Netezos**: Interacts with Tezos wallets through the Beacon standard for Windows, Linux, and MacOS platforms. Also prepares parameters for smart contract calls and interprets complex data returned by the ReadView method.
+
+The SDK also uses the [Newtonsoft JSON Unity Package](https://docs.unity3d.com/Packages/[email protected]/manual/index.html).
+
+## Supported Platforms
+
+The SDK supports Windows, Linux, MacOS, iOS, Android, and WebGL platforms.

docs/unity/prefabs.md

@@ -0,0 +1,36 @@
+---
+title: Unity SDK prefabs
+sidebar_label: Prefabs
+authors: Tim McMackin
+last_update:
+  date: 20 December 2023
+---
+
+The Tezos SDK for Unity provides these prefabs:
+
+## TezosManager
+
+This prefab sets the metadata for the scene, such as the application name that users see in their wallet applications before connecting to the project.
+It also initializes the Tezos SDK for use in the scene and creates an instance of the `TezosSDK.Tezos.Tezos` class, which provides access to the SDK objects such as the [Wallet](./reference/Wallet) and [EventManager](./reference/EventManager) objects.
+
+Its fields control what users see in their wallet applications before connecting to the project, as shown in this picture of the Inspector panel:
+
+<img src="/img/unity/unity-inspector-tezosmanager.png" alt="The Inspector panel, showing information about the project" style={{width: 300}} />
+
+## TezosAuthenticator
+
+This prefab provides code to connect to different kinds of Tezos wallets.
+
+If you copy this prefab into your scene and run the scene, it shows a QR code or connection buttons that Tezos wallet applications can scan to connect with the application.
+Whether it shows the QR code or buttons depends on whether the project is running in standalone, mobile, or WebGL mode.
+You can access these features through the prefab and change how the project manages its connection to users' wallets.
+
+The prefab's `LoginPanel` object includes objects that connect to wallets in different ways:
+
+- The `QRCode` object shows a QR code that wallet apps can scan to connect
+- The `LoginButtonDeepLink` object shows a button that opens a wallet app on a mobile device or a wallet browser extension in a web browser via the Beacon SDK
+- The `SocialLoginButton` object shows a button that opens a social wallet, such as Kukai
+
+For details about how the prefab works, see the file `Runtime/View/TezosAuthenticator.cs`.
+
+For an example of the prefab in use, see the [WalletConnection tutorial scene](./scenes#walletconnection-scene).