為錢包提供資金並授予代理程式許可

建立付款工具後，最終使用者必須使用 USDC 為錢包提供資金，並授予代理程式簽署交易的許可。在這兩個步驟完成之前，程序付款操作會失敗，並出現用戶端例外狀況。

Coinbase CDP

當您使用 Coinbase CDP 連接器建立付款工具時，CreatePaymentInstrumentAPI 會傳回redirectUrl指向 Coinbase WalletHub 的入口網站，以授予代理程式許可並為錢包提供資金。將最終使用者導向此 URL，以為其錢包提供資金，並從單一界面授予代理程式許可。

使用 WalletHub URL

redirectUrl 來自CreatePaymentInstrument回應的 會開啟 Coinbase WalletHub，最終使用者可以為錢包提供資金，並將簽署許可授予代理程式。

instrument = dp_client.create_payment_instrument(
    userId="test-user-123",
    paymentManagerArn=PAYMENT_MANAGER_ARN,
    paymentConnectorId=PAYMENT_CONNECTOR_ID,
    paymentInstrumentType="EMBEDDED_CRYPTO_WALLET",
    paymentInstrumentDetails={
        "embeddedCryptoWallet": {
            "network": "ETHEREUM",
            "linkedAccounts": [{"email": {"emailAddress": "user@example.com"}}]
        }
    },
    clientToken=str(uuid.uuid4()),
)

# Direct the end user to this URL
wallet_hub_url = instrument["paymentInstrumentDetails"]["redirectUrl"]
print(f"Open the WalletHub: {wallet_hub_url}")

或者，您可以在 GitHub 上部署 Coinbase AgentCore 範本做為自我託管的 Next.js 前端，該前端透過可自訂的 UI 提供相同的資金和許可功能。如需設定說明（替代） 部署自我託管前端，請參閱 。

為錢包提供資金

從 WalletHub （或自我託管前端），最終使用者可以使用下列任一方法為其錢包提供資金：

對於睪丸環境，請從 Circle USDC 龍頭使用睪丸 USDC 為錢包提供資金。

授予代理程式許可

Coinbase CDP 中的代理程式許可使用錢包範圍委派，每個錢包都會從授權代理程式簽署交易的最終使用者收到自己的獨立、有時間限制的授予。

一旦授予，代理程式可以代表最終使用者的錢包簽署交易，直到授予到期。最終使用者可以隨時從相同的儀表板撤銷許可。提供授予後，請繼續建立付款工作階段。

撤銷許可

最終使用者可以隨時從 WalletHub 或前端儀表板的許可區段撤銷代理程式對任何錢包的存取。撤銷後，在使用者授予新許可之前，代理程式無法再簽署該錢包的交易。

（替代） 部署自我託管前端

如果您需要可自訂的 UI 而非託管的 WalletHub，請將 Coinbase AgentCore 範本部署為自我託管的 Next.js 應用程式。

自我託管前端提供與上述相同的資金和許可授予流程，並完全控制樣式和使用者體驗。

條紋 （私有）

GitHub 上的 Privy AgentCore SDK 是 Next.js 參考前端，可讓最終使用者透過引導式設定流程來驗證、為錢包提供資金，以及授予代理程式許可。

部署前端

為錢包提供資金

當最終使用者透過 Privy 前端進行驗證時，會自動為 Base (EVM) 和 Solana 網路建立內嵌錢包。最終使用者可以使用下列任一方法為其錢包提供資金：

對於睪丸環境，請從 Circle USDC 龍頭使用睪丸 USDC 為錢包提供資金。

授予代理程式許可

Privy 中的代理程式許可使用工作階段簽署者 （也稱為授權金鑰） - 最終使用者在每個內嵌錢包上註冊代理程式的授權金鑰，授予代理程式簽署交易的許可，而無需按交易核准。

來自 Privy 開發套件addSessionSigners的前端呼叫，以在每個內嵌錢包上註冊代理程式的授權金鑰。操作是等冪的 - 如果簽署者已註冊，則不會傳回錯誤。

連線後，代理程式即可代表使用者的錢包簽署交易。許可會持續到明確撤銷為止。

（選用） 驗證客服人員連線

前端會呼叫 Privy API 來驗證許可是否處於作用中狀態：

GET https://auth.privy.io/api/v1/wallets/{walletId}
Authorization: Basic <base64(appId:appSecret)>

回應包含 additional_signers陣列。如果已設定的授權 ID 出現在此陣列中，表示代理程式已連線。

提供授予後，請繼續建立付款工作階段。

使用睪丸 USDC 進行測試

針對開發和測試，請使用測試網路和資金錢包搭配測試 USDC：