Update Delegation Toolkit API reference

* update smart account API reference

* add disableDelegation in API reference

* add new API reference for smart account

* add parameters

* Apply suggestions from code review

Co-authored-by: Alexandra Carrillo <[email protected]>

---------

Co-authored-by: “AyushBherwani1998” <“[email protected]”>
Co-authored-by: Alexandra Carrillo <[email protected]>

Author: 3 people

delegation-toolkit/reference/api/delegation.md

@@ -250,6 +250,47 @@ overrideDeployedEnvironment(
 // add-end
 ```
 
+## `disableDelegation`
+
+Encodes the calldata for disabling a delegation.
+
+### Parameters
+
+| Name | Type | Required | Description |
+| --- | --- | --- | --- |
+| `delegation` | `Delegation` | Yes | The delegation to be disabled. |
+
+### Example
+
+<Tabs>
+<TabItem value="example.ts">
+
+```ts
+import { DelegationManager } from "@metamask/delegation-toolkit/contracts";
+import { delegation } from "./delegation.ts";
+
+const disableDelegationData = DelegationManager.encode.disableDelegation({
+  delegation,
+});
+```
+
+</TabItem>
+<TabItem value="delegation.ts">
+
+```ts
+import { createDelegation } from "@metamask/delegation-toolkit";
+
+export const delegation = createDelegation({
+  from: "0x7E48cA6b7fe6F3d57fdd0448B03b839958416fC1",
+  to: "0x2B2dBd1D5fbeB77C4613B66e9F35dBfE12cB0488",
+  // Empty caveats array - we recommend adding appropriate restrictions
+  caveats: [],
+});
+```
+
+</TabItem>
+</Tabs>
+
 ## `getDeleGatorEnvironment`
 
 Resolves the `DeleGatorEnvironment` for a chain.

delegation-toolkit/reference/api/smart-account.md

@@ -116,6 +116,162 @@ export const bundlerClient = createBundlerClient({
 </TabItem>
 </Tabs>
 
+## `encodeCalls`
+
+Encodes calls for execution by a MetaMask smart account. If there's a single call directly to the smart account, it returns the call data directly. For multiple calls or calls to other addresses, it creates executions and encodes them for the smart account's `execute` function.
+
+The execution mode is set to `SINGLE_DEFAULT_MODE` for a single call to other address, or `BATCH_DEFAULT_MODE` for multiple calls.
+
+### Parameters
+
+| Name | Type | Required | Description |
+| ---- | ---- | -------- | ----------- |
+| `calls` | `Call[]` | Yes | List of calls to be encoded. |
+
+### Example 
+
+<Tabs>
+<TabItem value ="example.ts">
+
+```ts
+import { smartAccount } from "./config.ts";
+
+const calls = [{
+  to: zeroAddress,
+  data: "0x",
+  value: 0n
+}];
+
+const executeCallData = await smartAccount.encodeCalls(calls);
+```
+
+</TabItem>
+
+<TabItem value ="config.ts">
+
+```ts
+import { createPublicClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { sepolia as chain } from "viem/chains";
+import {
+  Implementation,
+  toMetaMaskSmartAccount,
+} from "@metamask/delegation-toolkit";
+
+const publicClient = createPublicClient({
+  chain,
+  transport: http(),
+});
+
+const delegatorAccount = privateKeyToAccount("0x...");
+
+export const smartAccount = await toMetaMaskSmartAccount({
+  client: publicClient,
+  implementation: Implementation.Hybrid,
+  deployParams: [delegatorAccount.address, [], [], []],
+  deploySalt: "0x",
+  signatory: { account: delegatorAccount },
+});
+```
+
+</TabItem>
+</Tabs>
+
+## `getFactoryArgs`
+
+Returns the factory address and factory data that can be used to deploy a smart account.
+
+### Example
+
+<Tabs>
+<TabItem value ="example.ts">
+
+```ts
+import { smartAccount } from "./config.ts";
+
+const { factory, factoryData } = await smartAccount.getFactoryArgs();
+```
+
+</TabItem>
+
+<TabItem value ="config.ts">
+
+```ts
+import { createPublicClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { sepolia as chain } from "viem/chains";
+import {
+  Implementation,
+  toMetaMaskSmartAccount,
+} from "@metamask/delegation-toolkit";
+
+const publicClient = createPublicClient({
+  chain,
+  transport: http(),
+});
+
+const delegatorAccount = privateKeyToAccount("0x...");
+
+export const smartAccount = await toMetaMaskSmartAccount({
+  client: publicClient,
+  implementation: Implementation.Hybrid,
+  deployParams: [delegatorAccount.address, [], [], []],
+  deploySalt: "0x",
+  signatory: { account: delegatorAccount },
+});
+```
+
+</TabItem>
+</Tabs>
+
+
+## `getNonce`
+
+Returns the nonce for a smart account.
+
+### Example
+
+<Tabs>
+<TabItem value ="example.ts">
+
+```ts
+import { smartAccount } from "./config.ts";
+
+const nonce = await smartAccount.getNonce();
+```
+
+</TabItem>
+
+<TabItem value ="config.ts">
+
+```ts
+import { createPublicClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { sepolia as chain } from "viem/chains";
+import {
+  Implementation,
+  toMetaMaskSmartAccount,
+} from "@metamask/delegation-toolkit";
+
+const publicClient = createPublicClient({
+  chain,
+  transport: http(),
+});
+
+const delegatorAccount = privateKeyToAccount("0x...");
+
+export const smartAccount = await toMetaMaskSmartAccount({
+  client: publicClient,
+  implementation: Implementation.Hybrid,
+  deployParams: [delegatorAccount.address, [], [], []],
+  deploySalt: "0x",
+  signatory: { account: delegatorAccount },
+});
+```
+
+</TabItem>
+</Tabs>
+
 ## `signDelegation`
 
 Signs the delegation and returns the delegation signature.