https://github.com/decentldotland/mem-carbon-testnet

MEM Carbon is a testnet network with temporal states storage
https://github.com/decentldotland/mem-carbon-testnet

Last synced: 3 days ago
JSON representation

MEM Carbon is a testnet network with temporal states storage

• Host: GitHub
• URL: https://github.com/decentldotland/mem-carbon-testnet
• Owner: decentldotland
• License: mit
• Created: 2023-11-15T12:32:44.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-02-05T15:59:29.000Z (9 months ago)
• Last Synced: 2024-04-14T10:45:35.497Z (7 months ago)
• Language: JavaScript
• Size: 40 KB
• Stars: 6
• Watchers: 0
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  

    

  

  
@decentldotland/mem-carbon-testnet

  
MEM Carbon is a testnet network with temporary state storage


## Build & Run Locally

```bash

git pull https://github.com/decentldotland/mem-carbon-testnet.git

npm install && npm run start

```

## Self Hosted Vs Served Endpoint

To keep your application data private, it's recommended to operate a local testnet instance. This will also enhance scalability and testing speed.

Nevertheless, the MEM team provides a publicly accessible endpoint. It's crucial to note that the testnet data is strictly temporary and is purged within a 1-2 day timeframe:

- Base endpoint: https://mem-testnet.xyz

- Akash hosted endpoint: http://ni8amicr1pfejdvrbav9r9grh8.ingress.d3akash.cloud/

## Testnet Methods

### Deploy a function

- `POST /deploy`

```js

import * as fs from 'fs';

import axios from 'axios';

const TESTNET_ENDPOINT = "https://mem-testnet.xyz/deploy";

async function deploy() {

  try {

    const sourceCode = fs.readFileSync("./func.js", { encoding: "utf8" }); // the src code of the function

    const initState = fs.readFileSync("./state.json", { encoding: "utf8" }); // the JSON initial function state

    

    const body = {

      src: sourceCode,

      state: initState,

    };

    

    const function_id = (await axios.post(TESTNET_ENDPOINT, body))?.data

      ?.function_id;

    console.log(function_id);

    return function_id;

  } catch (error) {

    console.log(error);

  }

}

```

### Send a transaction

- `POST /write`

```js

import axios from 'axios';

const TESTNET_ENDPOINT = "https://mem-testnet.xyz/write";

async function write() {

  try {

    const input = '{"function": "something"}'; // example: '{"function": "increment"}'

    const function_id = "your_function_id";

    const body = {

      input,

      function_id,

    };

    const result = (await axios.post(TESTNET_ENDPOINT, body))?.data;

    console.log(result);

    return result;

  } catch (error) {

    console.log(error);

  }

}

```

### Get function state

- `GET /state/:function_id`

### Get function data (state, source code, and exmContext)

- `GET /data/function/:function_id`

### Get all testnet deployed functions

- `GET /functions`

## Local Testing

You can use existing testing code snippets from this repository as follow:

```bash

npm run test-deploy

```

Grab the new function id, update the `./tests/write.js` file constant value of `FUNCTION_ID`, then run the following command

```bash

npm run test-write

```

## License

This repository is licensed under the [MIT License](./LICENSE)