Ame Network has been deployed on multiple testnets. This tutorial will guide you to quickly build a social component.

You can copy the Component template directly, or implement a component based on IComponent.

Component introduction:

The methodRequests and methodResponses are used to define the request parameter type and response data type of Method. Type is a data type Library, which contains all data types of solidity.

mapping (string=>Types.Type[]) methodRequests;
mapping (string=>Types.Type[]) methodResponses;

Method Types has 4 request types, GET, POST, PUT, OPTIONS. methods is used to store the method name array of each request type.

mapping (MethodTypes=>string[]) methods;

The options function will return the request method type supported by the component.

function options()public pure returns(MethodTypes[] memory){
  MethodTypes[] memory methodTypes=new MethodTypesUnsupported embed;
  methodTypes[0]=MethodTypes.GET;
  methodTypes[1]=MethodTypes.POST;
  methodTypes[2]=MethodTypes.PUT;
  methodTypes[3]=MethodTypes.OPTIONS;
  return methodTypes;
}

The setMethod is used to set the request parameter type and response data type of the method.

function setMethod(string memory _methodName,MethodTypes _methodType,Types.Type[] memory _methodReq,Types.Type[] memory _methodRes)  private  {
  methods[_methodType].push(_methodName);
  methodRequests[_methodName]=_methodReq;
  methodResponses[_methodName]=_methodRes;
 }

The getMethods returns the response method names according to the request type.

function getMethods(MethodTypes _methodTypes)public view returns (string[] memory){
    return methods[_methodTypes];
} 

The getMethodReqAndRes is used to obtain the request parameter type and response value type of the method based on the method name.

function getMethodReqAndRes(string memory _methodName)public view returns(Types.Type[] memory ,Types.Type[] memory ){
  return(
    methodRequests[_methodName],
    methodResponses[_methodName]
  );
}

Implement the functions of each method in get, post, and put .

function get(string memory _methodName,bytes memory _methodReq)public pure returns(bytes memory){
  return abi.encode(_methodName,_methodReq);
}

function post(string memory _methodName,bytes memory _methodReq)public payable returns(bytes memory){
  return abi.encode(_methodName,_methodReq);
}

function put(string memory _methodName,bytes memory _methodReq)public pure returns(bytes memory){
  return abi.encode(_methodName,_methodReq);
}

Component data is designed based on the functions provided by your component. Our example will implement user creation, query and modification.Each user has two data fields: name and age.

struct Profiles{
  string name;
  uint256 age;
}
mapping (address=>Profiles) users;

Initialize the methods you provide in the constructor. We initialize three request methods:

GET request, getUser, obtains the user's name and age.POST request, createUser, creates a user.PUT request, updateUserName, updates the user's name.

constructor(){
  Types.Type[] memory getReqArray = new Types.TypeUnsupported embed;
  getReqArray[0] = Types.Type.ADDRESS;
  Types.Type[] memory dataTypeArray = new Types.TypeUnsupported embed;
  dataTypeArray[0] = Types.Type.STRING;
  dataTypeArray[1] = Types.Type.UINT256;
  Types.Type[] memory putReqArray = new Types.TypeUnsupported embed;
  putReqArray[0] = Types.Type.ADDRESS;
  putReqArray[1] = Types.Type.STRING;
  setMethod("getUser",MethodTypes.GET,getReqArray,dataTypeArray);
  setMethod("createUser",MethodTypes.POST,dataTypeArray,new Types.TypeUnsupported embed);
  setMethod("updateUserName",MethodTypes.PUT,putReqArray,new Types.TypeUnsupported embed);
}

Implement each request method in GET, POST, and PUT.

    function get(string memory _methodName,bytes memory _methodReq)public view returns(bytes memory){
        if(compareStrings(_methodName,"getUser")){
            address user=abi.decode(_methodReq, (address));
            bytes memory userData=abi.encode(users[user].name,users[user].age);
            return userData;
        }else{
            return abi.encode("");
        }  
    }

    function post(string memory _methodName,bytes memory _methodReq)public payable returns(bytes memory){
        if(compareStrings(_methodName,"createUser")){
            (string memory name,uint256 age)=abi.decode(_methodReq, (string,uint256));
            users[msg.sender]=Profiles(name,age);
            bytes memory resBytes=abi.encode(name,age);
            emit  Response(resBytes);
            return resBytes;
        }
        return abi.encode("");
    }

    function put(string memory _methodName,bytes memory _methodReq)public payable returns(bytes memory){
        if(compareStrings(_methodName,"updateUserName")){
            (address userAddress,string memory name)=abi.decode(_methodReq, (address,string));
            require(userAddress==msg.sender);
            users[userAddress].name=name;
        }
        return abi.encode("");
    }

All code can be viewed at ComponentExample.

This component example has been deployed on multiple testnets.

Ame Components Scan is a manager for viewing social components of various networks. You can use it directly to interact with components.

1. Please select a network and connect your wallet.

2. Register as a new user

3. Enter component address to search.

4. Call methods in GET, POST, and PUT

If you want to contribute your components, you can refer to the component standard, I am still actively building Ame Network. If you are also interested, you can contact me on Twitter at any time.