docs: add docs for ownership transfer (#8)

site/.vitepress/config.ts

@@ -47,6 +47,8 @@ export default defineConfig({
             ],
           },
           { text: "Sponsoring Gas", items: [] },
+          { text: "Batching Transactions", items: [] },
+          { text: "Transferring Ownership", link: "/transferring-ownership" },
         ],
       },
       {
@@ -61,7 +63,13 @@ export default defineConfig({
             text: "aa-accounts",
             link: "/",
             base: "/packages/aa-accounts",
-            items: [{ text: "Contributing", link: "/contributing" }],
+            items: [
+              { text: "Contributing", link: "/contributing" },
+              {
+                text: "LightSmartContractAccount",
+                link: "/light-account",
+              },
+            ],
           },
           { text: "aa-ethers", link: "/aa-ethers" },
         ],

site/packages/aa-accounts/light-account.md

@@ -0,0 +1 @@
+# Light Account

site/smart-accounts/transferring-ownership.md

@@ -0,0 +1,82 @@
+---
+outline: deep
+head:
+  - - meta
+    - property: og:title
+      content: Transferring Ownership
+  - - meta
+    - name: description
+      content: Guide to transferring ownership of an account
+  - - meta
+    - property: og:description
+      content: Guide to transferring ownership of an account
+---
+
+# Transferring Ownership
+
+Not all accounts support transfering the owner (eg. SimpleAccount). However, a number of the accounts in this guide and in the Account Kit do! Let's see a few different ways we can transfer ownership of an Account (using Light Account as an example).
+
+## Light Account
+
+Light Account exposes the following method which allows the existing owner to transfer ownership to a new address:
+
+```solidity
+function transferOwnership(address newOwner) public virtual onlyOwner
+```
+
+There a number of ways you can call this method using the Account Kit.
+
+### 1. Using `sendUserOperation`
+
+Assuming you have connected the `provider` to a `LightAccount` using `provider.connect`, you can call `sendUserOperation` on the provider and encoding the transferOwnership call data:
+
+```ts
+import { encodeFunctionData } from "viem";
+
+const provider = // connect your provider to light account as outlined previously in the guide
+
+// this will return the address of the account you want to transfer ownerhip of
+const accountAddress = await provider.getAddress();
+const newOwner = "0x..."; // the address of the new owner
+
+const { hash: userOperationHash } = provider.sendUserOperation({
+  to: accountAddress,
+  data: encodeFunctionData({
+    abi: [
+      {
+        inputs: [
+          {
+            internalType: "address",
+            name: "newOwner",
+            type: "address",
+          },
+        ],
+        name: "transferOwnership",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+      },
+    ],
+    functionName: "transferOwnership",
+    args: [newOwner]
+  }),
+});
+```
+
+This pretty verbose and requires you to clog up your code with the ABI. Luckily `@alchemy/aa-accounts` exports a LightAccount class that makes this much easier.
+
+### 2. Using `LightSmartContractAccount`
+
+```ts
+import { LightSmartContractAccount } from "@alchemy/aa-accounts";
+
+const provider = // connect your provider to light account as outlined previously in the guide
+
+// this will return the address of the account you want to transfer ownerhip of
+const accountAddress = await provider.getAddress();
+const newOwner = "0x..."; // the address of the new owner
+
+const hash = LightSmartContractAccount.transferOwnership(provider, newOwner);
+```
+
+see the [`LightSmartContractAccount`](/packages/aa-accounts/light-account) docs for more details about this class.