REST APIs

APIs to manage projects and Forks

The instructions on how to get the API Key, Fork ID, RPC_ID, Project ID, and FORK_RPC can be found in this document.

We use API_KEY, FORK_ID, RPC_ID, PROJECT_ID, and FORK_RPCin the following to denote the concrete value.

Users can create their Forks under a project; each fork must belong to a project. After registering, a default project named 'default' will be made. Subsequently, users can create additional projects of their own.

  BlockSec App Suite
    |
    +---[Project 1]
    |
    +---[Project 2]
    |
    +---[Project 3]
         |
         +---[Fork 1]
         |
         +---[Fork 2]

Request and Response Format

The requested data is packed in the data field of the body. The response is in JSON format, with the following standard structure.

• code: Integer. Error code.

  • 0: No error.

  • other: Error occurs.

• message: String

  • If the code is not 0, this field denotes the detailed error information.

• data: JSON

  • This is the detailed response data.

Project Related APIs

Create a new project.

POST https://api.phalcon.blocksec.com/v1/project

Create a new project.

Headers

Name	Value
Content-Type	application/json
Access-Key*	API_KEY

Body

Name	Type	Description
data*	JSON	Request data

Requst

curl --location 'https://api.phalcon.blocksec.com/v1/project'
--header 'Access-Key: $API_KEY'
--header 'Content-Type: application/json'
--data '{ "name":"testApiProject" }'

Response

{
  "code": 0,
  "message": "ok",
  "data": {
    "projectId": "p_516xxxxxxxxxxxxxxxxc6d8c",
    "name": "testApiProject",
    "createTime": "2023-06-25 03:40:50"
  }
}

Get project list

GET https://api.phalcon.blocksec.com/v1/projects

Get the project list.

Headers

Name	Value
Content-Type (optional)	application/json
Access-Key*	API_KEY

Name	Type	Description
data	JSON	Request data

Requst

curl --location 'https://api.phalcon.blocksec.com/v1/projects'
--header 'Access-Key: $API_KEY'

Response

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "projectId": "p_1da225a5xxxxxxxxxxxxxxxxxxxxd885",
            "name": "Project_1",
            "createTime": "2023-06-20 10:37:06"
        },
        {
            "projectId": "p_b16004dxxxxxxxxxxxxxxxxxxxx13d",
            "name": "Project_2",
            "createTime": "2023-06-25 03:11:09"
        },
        {
            "projectId": "p_516b2bxxxxxxxxxxxxxxxxxxxxd8c",
            "name": "Project_3",
            "createTime": "2023-06-25 03:40:50"
        }
    ]
}

Response

• projectId: String. The ID of the created Project. This ID is used to manipulate a Project (e.g., delete a Project or create a Fork in this project).

• name: String. The name of the Project.

• createTime:String. The time of the project was created.

Get a project's detailed information.

GET https://api.phalcon.blocksec.com/v1/project/$projectId

Get a project's details, including the collaborators, forked created, and usage information.

Headers

Name	Value
Content-Type (optional)	application/json
Access-Key*	API_KEY

Name	Type	Description
data	JSON	Request data

Requst

curl --location 'https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID' \
--header 'Access-Key: $API_KEY'

Response

{
  "code": 0,
  "message": "ok",
  "data": {
    "projectId": "p_0eefxxxxxxxxxx5f",
    "name": "Learn Blockchain",
    "createTime": "2023-06-20 15:21:57",
    "collaboratorDetail": {
      "collaboratorNum": 1,
      "collaborators": [{
        "email": "[e-mail]",
        "name": "xxxxx"
      }]
    },
    "fokDetail": {
      "forkNum": 2,
      "forks": [{
        "forkId": "132-xxxx-xxxx-eae",
        "chainId": 1,
        "name": "TryUniswap",
        "url": "https://rpc.phalcon.blocksec.com/b0bb52xxxxxxfxxxxxxx10"
      }, {
        "forkId": "433xxxxx-yyyy-zzzz-aaaa-78811c05f471",
        "chainId": 56,
        "name": "Hello BSC",
        "url": "https://rpc.phalcon.blocksec.com/5d1a1exxxxxxxxxda7c4f"
      }],
      "stats": {
        "dailyTransactionQuantity": 0,
        "monthlyTransactionQuantity": 9
      }
    }
  }
}

Request

• PROJECT_ID: String. The ID of the Project that is to be queried ($PROJECT_ID)

Response

• projectId: String. The ID of the created Project. This ID is used to manipulate a Project (e.g., delete a Project or create a Fork in this project).

• name: String. The name of the Project.

• createTime:String. The time of the project was created.

• stats:Json. The statistics of the simulated transactions for this project.

  • dailyTransactionQuantity:Integer.Daily usage statistics (UTC)

  • monthlyTransactionQuantity:Integer.Monthly usage statistics from 1st of the month until now).

• fokDetail:Json. The detailed information on this project's forks.

  • forkId: String. The id of the created Fork. This id is used to manipulate a Fork (e.g., delete a Fork).

  • chainId: Integer. The id of the chain that is forked. It should be the same as the chainId passed in the request.

  • name: String. The name of the Fork. It should be the same as the name passed in the request.

  • rpc:String. The RPC of this Fork.

• collaboratorDetail: Json. The detailed information of this project's collaborators.

  • collaboratorNum: Integer.The number of collaborators

  • collaborators:Json. The collaborator information includes their nickname and email address.

Delete a Project

DELETE https://api.phalcon.blocksec.com/v1/project/delete/$PROJECT_ID

Delete a project.

Headers

Name	Value
Content-Type (optional)	application/json
Access-Key*	API_KEY

Name	Type	Description
data	JSON	Request data

Requst

curl --location  --request DELETE 'https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID' \
--header 'Access-Key: $API_KEY'

Response

{
    "code": 0,
    "message": "ok"
}

Request

• PROJECT_ID: String. The ID of the Project that is to be deleted.

Fork Related APIs

Create a Fork

POST https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID/fork

Create a Fork inside the project specified by $PROJECT_ID.

Headers

Name	Value
Content-Type*	application/json
Access-Key*	API_KEY

Name	Type	Description
data*	JSON	Request data

Requst

curl --location 'https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID/fork' \
--header 'Access-Key: $API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "chainId":1,
    "height": "safe",
    "name":"testApiFork",
    "position":20,
    "antiReplay": true
}'

Response

{
  "code": 0,
  "message": "ok",
  "data": {
    "forkId": "b480224a-8e0f-4e90-9e47-6017c7bdxxxx",
    "chainId": 9991,
    "name": "testApiFork111",
    "snapshotId": "b480224a-8e0f-4e90-9e47-6017c7bdadaa",
    "rpc": "https://rpc.phalcon.blocksec.com/xxxxxxxxfd2a4e5ca1179785xxxxxxxx"
  }
}

Request

• chainId: Integer. Following the IDs used in this website.

• height: It specifies the block height from which the chain is forked. It accepts the following options.

  • HEX String - an integer block number

  • String "safe" - for the latest safe head block

• position: Integer. The position in the block (specified by height) that the Forked chain starts. Read more about the height and position.

• name: String. The name of the created Fork.

• `antiReplay`: Boolean. It specifies whether the anti-replay feature is enabled for this Fork.

Response

• forkId: String. The id of the created Fork. This id is used to manipulate a Fork (e.g., delete a Fork).

• chainId: Integer. The id of the chain that is forked. It should be the same as the chainId passed in the request.

• name: String. The name of the Fork. It should be the same as the name passed in the request.

• snapshotId: String. The ID of the default snapshot of this Fork.

• rpc:String. The RPC of this Fork.

Delete a Fork

DELETE https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID/fork/$FORK_ID

Delete a Fork

Headers

Name	Value
Content-Type (optional)	application/json
Access-Key*	API_KEY

Requst

curl --location  --request DELETE 'https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID/fork/$FORK_ID' \
--header 'Access-Key: $API_KEY'

Response

{
    "code": 0,
    "message": "ok"
}

Request

• PROJECT_ID: String. The ID of the project that contains the Fork is to be deleted.

• FORK_ID: String. The ID of the Fork is to be deleted.

Get Fork List

GET https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID/forks

Get a list of Forks inside the project specified by $PROJECT_ID.

Headers

Name	Value
Content-Type (optional)	application/json
Access-Key*	API_KEY

Requst

curl --location 'https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID/forks' \
--header 'Access-Key: $API_KEY'

Response

{
    "code": 0,
    "data": [
        {
            "forkId": "621bf83d-9741-xxx-92c7-acdcc1399055",
            "name": "1",
            "rpc": "https://rpc.phalcon.xyz/xxx",
            "chainId": 9991
        },
        {
            "forkId": "3dbeb3a1-b3b4-xxx-91ea-c160a347a781",
            "name": "ETH1",
            "rpc": "https://rpc.phalcon.xyz/xxx",
            "chainId": 1
        },
        {
            "forkId": "f11f7186-a57a-xxx-b849-177577a1c130",
            "name": "eth",
            "rpc": "https://rpc.phalcon.xyz/xxx",
            "chainId": 1
        }
    ]
}

Request

• PROJECT_ID: String. The ID of the project.

Response

• forkId: String. The id of the Fork. This ID is used to manipulate a Fork (e.g., delete a Fork).

• chainId: Integer. The id of the chain that is forked. It should be the same as the chainId passed in the request.

• name: String. The name of the Fork. It should be the same as the name passed in the request.

• rpc:String. The RPC of this Fork.

Get Fork Information

GET https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID/fork/$FORK_ID

Given a FORK_ID, return the Fork information.

Headers

Name	Value
Content-Type (optional)	application/json
Access-Key*	API_KEY

Requst

curl --location 'https://api.phalcon.blocksec.com/v1/project/$PROJECT_ID/fork/$FORK_ID' \
--header 'Access-Key: $API_KEY'  

Response

{
	"code": 0,
	"data": {
		"forkId": "621bf83d-xxxx-xxx-92c7-zzzzzz",
		"name": "forkName",
		"rpc": "https://rpc.phalcon.blocksec.com/xxx",
		"chainId": 9991
	}
}

Request

• PROJECT_ID: String. The ID of the project.

• FORK_ID: String. The ID of the Fork.

Response

• forkId: String. The id of the Fork. This ID is used to manipulate a Fork (e.g., delete a Fork).

• chainId: Integer. The id of the chain that is forked. It should be the same as the chainId passed in the request.

• name: String. The name of the Fork. It should be the same as the name passed in the request.

• rpc:String. The RPC of this Fork.