> For the complete documentation index, see [llms.txt](/llms.txt).

# Request signature

The `request` method opens built-in transaction screens for signing transactions. The method returns a `SignResponse?`. Use it to sign transactions on any EVM chain. You can white-label the screens to match your branding.

See the list of [JSON-RPC methods](https://metamask-docs-git-ew-combined-sdk-doc-52f4ee-consensys-ddffed67.vercel.app/wallet/reference/json-rpc-api/). The `request` method currently supports only signing methods.

The SDK retrieves chain configuration automatically from your project settings in the Embedded Wallets dashboard. If the dashboard response has no `chains` field, the SDK uses the `chains` you pass in `Web3AuthOptions`. Wallet Services open on the first chain in the list.

The user must be signed in. The method throws an error if no user is signed in or if no chains are configured. It returns `nil` if the user closes the request screen without completing it.

![Request Method](/img/embedded-wallets/wallet-services/mobile-request-method.png) 

## Parameters

| Parameter       | Description                                                                                                                                                    |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `method`        | JSON RPC method name in `String`. Currently, the request method only supports the signing methods.                                                             |
| `requestParams` | Parameters for the corresponding method, in the correct sequence. See [JSON-RPC methods](https://metamask-docs-git-ew-combined-sdk-doc-52f4ee-consensys-ddffed67.vercel.app/wallet/reference/json-rpc-api/) for details. |
| `path?`         | Path in the wallet WebView. The default is `"wallet/request"`.                                                                                                 |
| `appState?`     | Optional app state string to be passed through the request flow.                                                                                               |

## Usage

```swift
do {
    var params = [Any]()
    // Message to be signed
    params.append("Hello, Web3Auth from iOS!")
    // User's EOA address
    params.append(address)

    let response = try await web3Auth.request(
        method: "personal_sign",
        requestParams: params
    )

    if let response = response {
        if response.success {
            print(response.result!)
        } else {
            // Handle Error
            print(response.error!)
        }
    }
} catch {
    print(error.localizedDescription)
    // Handle error
}

```

## SignResponse

| Name      | Description                                                   |
| --------- | ------------------------------------------------------------- |
| `success` | Whether the request succeeded.                                |
| `result?` | Holds the signature for the request when `success` is `true`. |
| `error?`  | Holds the error for the request when `success` is `false`.    |