1 of 8

Hedera Smart Contract Service APIs

hscs/createSmartContract

How to call the API from an app

Hedera Wallet Snap connects to your currently connected Metamask account by default. To learn how apps can connect to Hedera Wallet Snap using a non-metamask(external) account, refer to this .

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

hscs/updateSmartContract

How to call the API from an app

Hedera Wallet Snap connects to your currently connected Metamask account by default. To learn how apps can connect to Hedera Wallet Snap using a non-metamask(external) account, refer to this .

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

hscs/deleteSmartContract

How to call the API from an app

Hedera Wallet Snap connects to your currently connected Metamask account by default. To learn how apps can connect to Hedera Wallet Snap using a non-metamask(external) account, refer to this documentation.

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

If you had not created your smart contract setting the adminKey,you will not be able to delete your smart contract

What the API does

Retrieves the currently connected account the user has selected on Metamask. If it's the first time, a new is created and the account info is saved in snap state.
Parses the arguments that were passed such as the contractid, transferAccountId, transferContractId, etc.
Calls the to delete a smart contract from the Hedera network. Once a smart contract is marked deleted, you will not be able to modify any of the contract's properties.

An example response:

Live Demo on CodePen

Note: Visit to activate your hedera account before you interact with the demo
If you're getting any errors with the live demo, make sure you go through the section to learn about what you may be missing. You need to install in your browser for the live demo to work.

hscs/callSmartContractFunction

How to call the API from an app

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

The call can use at maximum the given amount of gas – the paying account will not be charged for any unspent gas.

What the API does

Retrieves the currently connected account the user has selected on Metamask. If it's the first time, a new is created and the account info is saved in snap state.
Parses the arguments that were passed such as the gas, bytecode, adminKey, etc.
Calls the to call a function of the given smart contract instance, giving it functionParameters as its input.

An example response:

Live Demo on CodePen

Note: Visit to activate your hedera account before you interact with the demo
If you're getting any errors with the live demo, make sure you go through the section to learn about what you may be missing. You need to install in your browser for the live demo to work.

hscs/getSmartContractFunction

How to call the API from an app

Hedera Wallet Snap connects to your currently connected Metamask account by default. To learn how apps can connect to Hedera Wallet Snap using a non-metamask(external) account, refer to this .

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

hscs/getSmartContractBytecode

How to call the API from an app

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

What the API does

Retrieves the currently connected account the user has selected on Metamask. If it's the first time, a new is created and the account info is saved in snap state.
Parses the arguments that were passed such as the gas, bytecode, adminKey, etc.
Calls the to query the network that returns the bytecode for a smart contract instance.

An example response:

Live Demo on CodePen

Note: Visit to activate your hedera account before you interact with the demo
If you're getting any errors with the live demo, make sure you go through the section to learn about what you may be missing. You need to install in your browser for the live demo to work.

hscs/getSmartContractInfo

How to call the API from an app

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

What the API does

Retrieves the currently connected account the user has selected on Metamask. If it's the first time, a new is created and the account info is saved in snap state.
Parses the arguments that were passed such as the gas, bytecode, adminKey, etc.
Calls the to query the network that returns the current state of a smart contract instance, including its balance.

An example response:

Live Demo on CodePen

Note: Visit to activate your hedera account before you interact with the demo
If you're getting any errors with the live demo, make sure you go through the section to learn about what you may be missing. You need to install in your browser for the live demo to work.

hscs/getSmartContractInfo

How to call the API from an app

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

const snapId = `npm:@hashgraph/hedera-wallet-snap`

const getSmartContractInfoAPI = async () => {
  const externalAccountParams = {
    externalAccount: {
      accountIdOrEvmAddress: '0.0.12345',
      curve: 'ED25519'
    }
  }

  await window.ethereum.request({
    method: 'wallet_invokeSnap',
    params: {
      snapId,
      request: {
        method: 'hscs/getSmartContractInfo',
        params: {
          network: 'testnet',
          contractId: '0.0.4409710'
          /* 
            Uncomment the below line if you want to connect 
            to a non-metamask account
          */
          // ...externalAccountParams
        }
      }
    }
  })
}

What the API does

Retrieves the currently connected account the user has selected on Metamask. If it's the first time, a new is created and the account info is saved in snap state.
Parses the arguments that were passed such as the gas, bytecode, adminKey, etc.
Calls the to query the network that returns the current state of a smart contract instance, including its balance.

An example response:

Live Demo on CodePen

Note: Visit to activate your hedera account before you interact with the demo
If you're getting any errors with the live demo, make sure you go through the section to learn about what you may be missing. You need to install in your browser for the live demo to work.

hscs/callSmartContractFunction

How to call the API from an app

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

const snapId = `npm:@hashgraph/hedera-wallet-snap`

type SmartContractFunctionParameter = {
    type: 'string' | 'bytes' | 'boolean' | 'int' | 'uint';
    value: string | number | boolean | Uint8Array;
}

const callSmartContractFunctionAPI = async () => {
  const externalAccountParams = {
    externalAccount: {
      accountIdOrEvmAddress: '0.0.12345',
      curve: 'ED25519'
    }
  }

  await window.ethereum.request({
    method: 'wallet_invokeSnap',
    params: {
      snapId,
      request: {
        method: 'hscs/callSmartContractFunction',
        params: {
          network: 'testnet',
          contractId: '0.0.4409710',
          functionName: 'setGreeting',
          functionParams?, // Optional param - type: SmartContractFunctionParameter[]
          gas?, // Optional param - type: number
          senderAccountId?: // Optional param - type: string
          /* 
            Uncomment the below line if you want to connect 
            to a non-metamask account
          */
          // ...externalAccountParams
        }
      }
    }
  })
}

The call can use at maximum the given amount of gas – the paying account will not be charged for any unspent gas.

What the API does

Retrieves the currently connected account the user has selected on Metamask. If it's the first time, a new is created and the account info is saved in snap state.
Parses the arguments that were passed such as the gas, bytecode, adminKey, etc.
Calls the to call a function of the given smart contract instance, giving it functionParameters as its input.

An example response:

Live Demo on CodePen

Note: Visit to activate your hedera account before you interact with the demo
If you're getting any errors with the live demo, make sure you go through the section to learn about what you may be missing. You need to install in your browser for the live demo to work.

hscs/deleteSmartContract

How to call the API from an app

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

const snapId = `npm:@hashgraph/hedera-wallet-snap`

const deleteSmartContractAPI = async () => {
  const externalAccountParams = {
    externalAccount: {
      accountIdOrEvmAddress: '0.0.12345',
      curve: 'ED25519'
    }
  }

  await window.ethereum.request({
    method: 'wallet_invokeSnap',
    params: {
      snapId,
      request: {
        method: 'hscs/deleteSmartContract',
        params: {
          network: 'testnet',
          contractId: '0.0.4409710',
          transferAccountId?, // Optional param - type: string
          transferContractId?, // Optional param - type: string
          /* 
            Uncomment the below line if you want to connect 
            to a non-metamask account
          */
          // ...externalAccountParams
        }
      }
    }
  })
}

If you had not created your smart contract setting the adminKey,you will not be able to delete your smart contract

What the API does

Retrieves the currently connected account the user has selected on Metamask. If it's the first time, a new is created and the account info is saved in snap state.
Parses the arguments that were passed such as the contractid, transferAccountId, transferContractId, etc.
Calls the to delete a smart contract from the Hedera network. Once a smart contract is marked deleted, you will not be able to modify any of the contract's properties.

An example response:

Live Demo on CodePen

Note: Visit to activate your hedera account before you interact with the demo
If you're getting any errors with the live demo, make sure you go through the section to learn about what you may be missing. You need to install in your browser for the live demo to work.

hscs/getSmartContractBytecode

How to call the API from an app

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

const snapId = `npm:@hashgraph/hedera-wallet-snap`

const getSmartContractBytecodeAPI = async () => {
  const externalAccountParams = {
    externalAccount: {
      accountIdOrEvmAddress: '0.0.12345',
      curve: 'ED25519'
    }
  }

  await window.ethereum.request({
    method: 'wallet_invokeSnap',
    params: {
      snapId,
      request: {
        method: 'hscs/getSmartContractBytecode',
        params: {
          network: 'testnet',
          contractId: '0.0.4409710'
          /* 
            Uncomment the below line if you want to connect 
            to a non-metamask account
          */
          // ...externalAccountParams
        }
      }
    }
  })
}

What the API does

Retrieves the currently connected account the user has selected on Metamask. If it's the first time, a new is created and the account info is saved in snap state.
Parses the arguments that were passed such as the gas, bytecode, adminKey, etc.
Calls the to query the network that returns the bytecode for a smart contract instance.

An example response:

Live Demo on CodePen

Note: Visit to activate your hedera account before you interact with the demo
If you're getting any errors with the live demo, make sure you go through the section to learn about what you may be missing. You need to install in your browser for the live demo to work.

Hedera Smart Contract Service APIs

hscs/createSmartContract

hashtagHow to call the API from an app

hscs/updateSmartContract

hashtagHow to call the API from an app

hscs/deleteSmartContract

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

hscs/callSmartContractFunction

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

hscs/getSmartContractFunction

hashtagHow to call the API from an app

hscs/getSmartContractBytecode

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

hscs/getSmartContractInfo

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

hscs/getSmartContractInfo

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

Hedera Smart Contract Service APIs

hscs/callSmartContractFunction

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

hscs/deleteSmartContract

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

hscs/getSmartContractFunction

hashtagHow to call the API from an app

hscs/updateSmartContract

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

hashtagWhat the API does

hashtagLive Demo on CodePen

hscs/createSmartContract

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

hscs/getSmartContractBytecode

hashtagHow to call the API from an app

hashtagWhat the API does

hashtagLive Demo on CodePen

How to call the API from an app

How to call the API from an app

How to call the API from an app

What the API does

Live Demo on CodePen

How to call the API from an app

What the API does

Live Demo on CodePen

How to call the API from an app

How to call the API from an app

What the API does

Live Demo on CodePen

How to call the API from an app

What the API does

Live Demo on CodePen

How to call the API from an app

What the API does

Live Demo on CodePen

How to call the API from an app

What the API does

Live Demo on CodePen

How to call the API from an app

What the API does

Live Demo on CodePen

How to call the API from an app

How to call the API from an app

What the API does

Live Demo on CodePen

What the API does

Live Demo on CodePen

How to call the API from an app

What the API does

Live Demo on CodePen

How to call the API from an app

What the API does

Live Demo on CodePen