transactions.getByHash()

transactions.getByHash(hash: string): Promise<Transaction>

interface Transaction {
  id: string;
  piid?: string | null;
  payer: string;
  pay_to: string;
  amount: string;
  asset: string;
  entry_id?: string | null;
  transaction_hash: string;
  created_at: number;
}

const tx = await grapevine.transactions.getByHash(
  '0xabc123def456789abc123def456789abc123def456789abc123def456789abcd'
);
 
console.log('Transaction found:');
console.log('  ID:', tx.id);
console.log('  Payer:', tx.payer);
console.log('  Recipient:', tx.pay_to);
console.log('  Amount:', formatUSDC(tx.amount));

async function verifyOnChainPayment(txHash: string) {
  try {
    const tx = await grapevine.transactions.getByHash(txHash);
    
    return {
      verified: true,
      platformTxId: tx.id,
      amount: formatUSDC(tx.amount),
      asset: tx.asset,
      payer: tx.payer,
      recipient: tx.pay_to,
      entry: tx.entry_id,
      timestamp: new Date(tx.created_at * 1000)
    };
  } catch (error) {
    if (error.message.includes('404')) {
      return {
        verified: false,
        error: 'Transaction not found in Grapevine system'
      };
    }
    throw error;
  }
}
 
// Usage
const result = await verifyOnChainPayment('0xabc123...');
if (result.verified) {
  console.log(`Payment of ${result.amount} verified!`);
} else {
  console.log('Payment not found');
}

async function getGrapevineTransaction(blockchainTxHash: string) {
  const tx = await grapevine.transactions.getByHash(blockchainTxHash);
  
  // Now we have the Grapevine transaction ID
  // Can use this to link to entry, feeds, etc.
  
  if (tx.entry_id) {
    console.log('Payment was for entry:', tx.entry_id);
  }
  
  return tx;
}

function getExplorerLinks(tx: Transaction, network: 'testnet' | 'mainnet') {
  const baseUrl = network === 'mainnet' 
    ? 'https://basescan.org' 
    : 'https://sepolia.basescan.org';
  
  return {
    transaction: `${baseUrl}/tx/${tx.transaction_hash}`,
    payer: `${baseUrl}/address/${tx.payer}`,
    recipient: `${baseUrl}/address/${tx.pay_to}`
  };
}
 
// Usage
const tx = await grapevine.transactions.getByHash(txHash);
const links = getExplorerLinks(tx, 'testnet');
console.log('View on explorer:', links.transaction);

try {
  const tx = await grapevine.transactions.getByHash(hash);
  console.log('Transaction found:', tx);
} catch (error) {
  if (error.message.includes('404')) {
    console.error('Transaction not found - may not be a Grapevine payment');
  } else if (error.message.includes('400')) {
    console.error('Invalid hash format - must be 0x followed by 64 hex characters');
  } else {
    console.error('Error:', error.message);
  }
}