Verify Stylus Source Code

curl --request POST \
  --url 'https://api.etherscan.io/v2/api?apikey=' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data codeformat=stylus \
  --data sourceCode=https://github.com/OffchainLabs/stylus-hello-world \
  --data contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  --data contractname=stylus_hello_world \
  --data compilerversion=stylus:0.5.3 \
  --data licenseType=3

import requests

url = "https://api.etherscan.io/v2/api?apikey="

payload = {
    "codeformat": "stylus",
    "sourceCode": "https://github.com/OffchainLabs/stylus-hello-world",
    "contractaddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "contractname": "stylus_hello_world",
    "compilerversion": "stylus:0.5.3",
    "licenseType": "3"
}
headers = {"Content-Type": "application/x-www-form-urlencoded"}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: new URLSearchParams({
    codeformat: 'stylus',
    sourceCode: 'https://github.com/OffchainLabs/stylus-hello-world',
    contractaddress: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
    contractname: 'stylus_hello_world',
    compilerversion: 'stylus:0.5.3',
    licenseType: '3'
  })
};

fetch('https://api.etherscan.io/v2/api?apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "codeformat=stylus&sourceCode=https%3A%2F%2Fgithub.com%2FOffchainLabs%2Fstylus-hello-world&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&contractname=stylus_hello_world&compilerversion=stylus%3A0.5.3&licenseType=3",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/x-www-form-urlencoded"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?apikey="

	payload := strings.NewReader("codeformat=stylus&sourceCode=https%3A%2F%2Fgithub.com%2FOffchainLabs%2Fstylus-hello-world&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&contractname=stylus_hello_world&compilerversion=stylus%3A0.5.3&licenseType=3")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.etherscan.io/v2/api?apikey=")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .body("codeformat=stylus&sourceCode=https%3A%2F%2Fgithub.com%2FOffchainLabs%2Fstylus-hello-world&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&contractname=stylus_hello_world&compilerversion=stylus%3A0.5.3&licenseType=3")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "codeformat=stylus&sourceCode=https%3A%2F%2Fgithub.com%2FOffchainLabs%2Fstylus-hello-world&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&contractname=stylus_hello_world&compilerversion=stylus%3A0.5.3&licenseType=3"

response = http.request(request)
puts response.read_body

{
    "status": "1",
    "message": "OK",
    "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj"
}

POST

api

Verify Stylus Source Code

curl --request POST \
  --url 'https://api.etherscan.io/v2/api?apikey=' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data codeformat=stylus \
  --data sourceCode=https://github.com/OffchainLabs/stylus-hello-world \
  --data contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  --data contractname=stylus_hello_world \
  --data compilerversion=stylus:0.5.3 \
  --data licenseType=3

import requests

url = "https://api.etherscan.io/v2/api?apikey="

payload = {
    "codeformat": "stylus",
    "sourceCode": "https://github.com/OffchainLabs/stylus-hello-world",
    "contractaddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "contractname": "stylus_hello_world",
    "compilerversion": "stylus:0.5.3",
    "licenseType": "3"
}
headers = {"Content-Type": "application/x-www-form-urlencoded"}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: new URLSearchParams({
    codeformat: 'stylus',
    sourceCode: 'https://github.com/OffchainLabs/stylus-hello-world',
    contractaddress: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
    contractname: 'stylus_hello_world',
    compilerversion: 'stylus:0.5.3',
    licenseType: '3'
  })
};

fetch('https://api.etherscan.io/v2/api?apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "codeformat=stylus&sourceCode=https%3A%2F%2Fgithub.com%2FOffchainLabs%2Fstylus-hello-world&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&contractname=stylus_hello_world&compilerversion=stylus%3A0.5.3&licenseType=3",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/x-www-form-urlencoded"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?apikey="

	payload := strings.NewReader("codeformat=stylus&sourceCode=https%3A%2F%2Fgithub.com%2FOffchainLabs%2Fstylus-hello-world&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&contractname=stylus_hello_world&compilerversion=stylus%3A0.5.3&licenseType=3")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.etherscan.io/v2/api?apikey=")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .body("codeformat=stylus&sourceCode=https%3A%2F%2Fgithub.com%2FOffchainLabs%2Fstylus-hello-world&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&contractname=stylus_hello_world&compilerversion=stylus%3A0.5.3&licenseType=3")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "codeformat=stylus&sourceCode=https%3A%2F%2Fgithub.com%2FOffchainLabs%2Fstylus-hello-world&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&contractname=stylus_hello_world&compilerversion=stylus%3A0.5.3&licenseType=3"

response = http.request(request)
puts response.read_body

{
    "status": "1",
    "message": "OK",
    "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj"
}

Arbitrum One Mainnet Arbitrum Sepolia Testnet

{
    "status": "1",
    "message": "OK",
    "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj"
}

Authorizations

apikey

string

query

required

Enter your Etherscan API key, or set one up if you don't have one.

Query Parameters

chainid

string

required

Chain ID to query, eg 42161 for Arbitrum One from our supported chains.

module

string

default:contract

required

Set to contract for this endpoint.

action

string

default:verifysourcecode

required

Set to verifysourcecode for this endpoint.

Body

application/x-www-form-urlencoded

codeformat

string

required

Use stylus for Stylus projects.

Example:

"stylus"

sourceCode

string

required

Public Git repository that hosts the Stylus source code.

Example:

"https://github.com/OffchainLabs/stylus-hello-world"

contractaddress

string

required

The address where the contract is deployed.

Example:

"0xdAC17F958D2ee523a2206206994597C13D831ec7"

contractname

string

required

The contract name that matches your Stylus deployment.

Example:

"stylus_hello_world"

compilerversion

string

required

Stylus compiler version used for compilation.

Example:

"stylus:0.5.3"

licenseType

integer

License identifier from the open source license options.

Example:

3

Response

200 - application/json

Successful response

status

string

1 if the request returned data, 0 otherwise. A status of 0 can indicate an error or a valid request that returned no records.

message

string

OK on success, otherwise an error description such as NOTOK. See common error messages.

result

string

GUID for the verification submission. Use it with checkverifystatus to poll the result.

API Endpoints

Beta Endpoints

Verify Stylus Source Code

Authorizations

Query Parameters

Body

Response