When you deploy a Typescript Function the code is stored and pinned on IPFS making it accessible to everyone. If you would prefer to conceal your code, one approach is to store your code in a private Github Gist. Subsequently, this code can be retrieved and executed through a Web3 Function.
Note: this approach introduces a dependency on Github's availability. We aim to directly support private Web3 Function deployments in the future.
Private Typescript Function example
This Typescript Function fetches onRun.js (Github gist containing concealed code) with its gist id and executes it during runtime. Check out the example on GitHub .
The code in onRun.jsmust be in JavaScript
private-w3f/index.ts
import {
Web3Function,
Web3FunctionContext,
Web3FunctionResult,
} from "@gelatonetwork/web3-functions-sdk";
import { Octokit } from "octokit";
// import dependencies used in onRun.js
import { ethers } from "ethers";
import ky from "ky";
Web3Function.onRun(async (context: Web3FunctionContext) => {
const { secrets } = context;
const gistId = (await secrets.get("GIST_ID")) as string;
const octokit = new Octokit();
let onRunScript: string | undefined;
// fetch onRun.js from private github gist
try {
const gistDetails = await octokit.rest.gists.get({
gist_id: gistId,
});
const files = gistDetails.data.files;
if (!files) throw new Error(`No files in gist`);
for (const file of Object.values(files)) {
if (file?.filename === "onRun.js" && file.content) {
onRunScript = file.content;
break;
}
}
if (!onRunScript) throw new Error(`No onRun.js`);
} catch (err) {
return {
canExec: false,
message: `Error fetching gist: ${err.message}`,
};
}
// run onRun.js
try {
/**
* context are passed into onRun.js.
* onRun.js will have access to all userArgs, secrets & storage
*/
const onRunFunction = new Function("context", "ky", "ethers", onRunScript);
const onRunResult: Web3FunctionResult = await onRunFunction(
context,
ky,
ethers
);
if (onRunResult) {
return onRunResult;
} else {
return { canExec: false, message: `No result returned` };
}
} catch (err) {
console.log(err);
return {
canExec: false,
message: `Error running gist: ${err.message}`,
};
}
});
Writing onRun.js
1. onRun.js file structure
onRun.js should return a promise.
onRun.js
return (async () => {
// ... your code here
})();
2. Using dependencies
Dependencies that are used in onRun.js should be imported into the Web3 Function index.ts file, not in onRun.js.
private-w3f/index.ts
// import dependencies used in onRun.js
import { ethers } from "ethers";
import ky from "ky";
3. Accessing Web3 Function Context
Web3 Function context which includes, secrets, userArgs, multiChainProvider can be accessed normally in onRun.js .
Make sure to store your GitHub gist id as a secret.
Arguments (not strict)
Since GitHub gists are editable, you can have a userArgs to be a JSON string so that arguments can be editable without re-deploying a web3 function with a different schema.
