Introduction

const response = await fetch(`https://api.heyvincent.ai/app/${appId}`);
const appInfo = await response.json();

// Display app info to user before installation
console.log(`App: ${appInfo.name}`);
console.log(`Description: ${appInfo.description}`);

{
  "agentSignerAddress": "0xPKPAddress...",
  "agentSmartAccountAddress": "0xSmartAccountAddress...",
  "appInstallationDataToSign": {
    "typedData": {
      "domain": { ... },
      "types": { ... },
      "message": { ... }
    }
  }
}

const response = await fetch(`https://api.heyvincent.ai/user/${appId}/install-app`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    userControllerAddress: userWallet.address
  })
});

const installData = await response.json();

{
  "transactionHash": "0xTransactionHash..."
}

// Sign the typed data with the user's wallet
const { typedData } = installData.appInstallationDataToSign;
const { EIP712Domain, ...types } = typedData.types;

const signature = await userWallet._signTypedData(
  typedData.domain,
  types,
  typedData.message
);

// Complete the installation
const response = await fetch(`https://api.heyvincent.ai/user/${appId}/complete-installation`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    typedDataSignature: signature,
    appInstallationDataToSign: installData.appInstallationDataToSign
  })
});

const result = await response.json();
console.log(`Installation tx: ${result.transactionHash}`);

{
  "agentAddress": "0xAgentSmartAccountAddress..."
}

{
  "agentAddress": null
}

const response = await fetch(`https://api.heyvincent.ai/user/${appId}/agent-account`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    userControllerAddress: userWallet.address
  })
});

const { agentAddress } = await response.json();

if (agentAddress) {
  console.log(`User has installed app. Agent address: ${agentAddress}`);
  // Display the agent address and any associated balances
} else {
  console.log('User has not installed this app');
  // Show installation prompt
}