Surf: TypeScript Type Safety for Move Contracts

Surf is a TypeScript library built on top of the Aptos TypeScript SDK and the wallet adapter that provides static type safety for your Move contracts by inferring type from contract ABI (Application Binary Interface). It allows you to catch type errors at compile time rather than at runtime. Most existing TypeScript IDEs will automatically provide warnings if you try to access fields that don’t exist, or provide wrong input types.

1. Step 1

   First, download the ABI of the Move contract and save it to a TypeScript file. In this case, we’re naming the file abi.ts in the src/utils folder.

   • macOS & Linux
   • Windows

   #! /bin/bash
   
   # replace it with the network your contract lives on
   NETWORK=testnet
   # replace it with your contract address
   CONTRACT_ADDRESS=0x12345
   # replace it with your module name, every .move file except move script has module_address::module_name {}
   MODULE_NAME=fungible_asset_launchpad
   
   # save the ABI to a TypeScript file
   echo "export const ABI = $(curl https://fullnode.$NETWORK.aptoslabs.com/v1/accounts/$CONTRACT_ADDRESS/module/$MODULE_NAME | sed -n 's/.*"abi":\({.*}\).*}$/\1/p') as const" > abi.ts

2. Step 2

   With the ABI, you can use Surf as a layer on top of the Aptos TypeScript SDK client Aptos, when interacting with Move contracts. For non-contract related operations, the Aptos will still need to be used.

   import { createSurfClient } from '@thalalabs/surf';
   import { Aptos, AptosConfig, NETWORK } from "@aptos-labs/ts-sdk";
   import { ABI } from "./abi";
   
   // First, create an Aptos client, make sure the network is the one that contract lives on
   export const aptos = new Aptos(new AptosConfig({ network: Network.DEVNET }));
   // Second, create a SurfClient with the Aptos client and the ABI
   export const surfClient = createSurfClient(aptos).useABI(ABI);
   
   // Use Surf to executes an entry function
   const result = await surfClient.entry.transfer({
     functionArguments: ['0x1', 1],
     typeArguments: ['0x1::aptos_coin::AptosCoin'],
     account: Account.fromPrivateKey(...),
   });
   
   // Use Surf to query a view function
   const [balance] = await surfClient.view.balance({
     functionArguments: ['0x1'],
     typeArguments: ['0x1::aptos_coin::AptosCoin'],
   });

• Surf GitHub
• A simple Next.js example demonstrating Surf
• An example of a fungible asset launchpad using Surf: This example is part of the Solana to Aptos guide on Aptos Learn, you can try it here and read the complete tutorial here.

Surf is built by Thala Labs, an Aptos ecosystem project, and maintained together by the Aptos community.

If you have any feedback or questions, please open an issue on Surf’s GitHub.