{"id":30896913,"url":"https://github.com/circlefin/stablecoin-aptos","last_synced_at":"2026-02-13T00:09:22.633Z","repository":{"id":308247781,"uuid":"881587510","full_name":"circlefin/stablecoin-aptos","owner":"circlefin","description":"Source repository for smart contracts used by Circle's stablecoins on Aptos blockchain","archived":false,"fork":false,"pushed_at":"2025-08-04T22:05:26.000Z","size":270,"stargazers_count":5,"open_issues_count":3,"forks_count":12,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-05T00:34:56.480Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Move","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/circlefin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-10-31T21:42:30.000Z","updated_at":"2025-08-04T22:04:17.000Z","dependencies_parsed_at":"2025-08-05T00:35:00.455Z","dependency_job_id":"cbcf50c6-d67f-4e6a-b439-a03f681a41a6","html_url":"https://github.com/circlefin/stablecoin-aptos","commit_stats":null,"previous_names":["circlefin/stablecoin-aptos"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/circlefin/stablecoin-aptos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circlefin%2Fstablecoin-aptos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circlefin%2Fstablecoin-aptos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circlefin%2Fstablecoin-aptos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circlefin%2Fstablecoin-aptos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/circlefin","download_url":"https://codeload.github.com/circlefin/stablecoin-aptos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circlefin%2Fstablecoin-aptos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274231140,"owners_count":25245675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-08T02:00:09.813Z","response_time":121,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-08T23:47:47.696Z","updated_at":"2026-02-13T00:09:22.607Z","avatar_url":"https://github.com/circlefin.png","language":"Move","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stablecoin-aptos\n\nSource repository for smart contracts used by Circle's stablecoins on Aptos blockchain\n\n## Getting Started\n\n### Prerequisites\n\nBefore you can start working with the contracts in this repository,\n\n1. [Optional] Create a directory to store Aptos-related binaries:\n\n   ```bash\n   mkdir -p $HOME/.aptos/bin/\n   echo 'export APTOS_BIN=\"$HOME/.aptos/bin\"' \u003e\u003e ~/.zshrc\n   echo 'export PATH=\"$APTOS_BIN:$PATH\"' \u003e\u003e ~/.zshrc\n   ```\n\n2. Install the necessary tools\n\n   ```bash\n   make setup\n   ```\n\nA guide on installing the CLI tools in other environments can be found [here](https://aptos.dev/en/build/cli).\n\n### IDE\n\nThe recommended IDE for this repository is VSCode. To get your IDE set up:\n\n1. Install the recommended extensions in VSCode. Enter `@recommended` into the search bar in the Extensions panel and install each of the extensions\n2. Install the [`aptos-move-analyzer`](https://github.com/movebit/aptos-move-analyzer) binary, ensuring that it can be found on your PATH\n\n   ```sh\n   mkdir -p $HOME/.aptos/bin/\n   curl -L -o \"$HOME/.aptos/bin/aptos-move-analyzer\" \"https://github.com/movebit/aptos-move-analyzer/releases/download/v1.0.0/aptos-move-analyzer-mac-x86_64-v1.0.0\"\n   chmod +x $HOME/.aptos/bin/aptos-move-analyzer\n   echo 'export PATH=\"$HOME/.aptos/bin:$PATH\"' \u003e\u003e ~/.zshrc\n   ```\n\n### Test Move contracts\n\n1. Run all Move tests:\n\n   ```bash\n   make test\n   ```\n\n   Coverage info is printed by default with this command.\n\n2. Code formatting:\n\n   ```bash\n   make fmt\n   ```\n\n## Localnet testing\n\nTo test the contracts on a localnet:\n\n1. Start the local network.\n\n   ```sh\n   make start-network\n   ```\n\n2. Create a local account and fund it with APT\n\n   ```sh\n   make create-local-account\n   ```\n\n3. Deploy `aptos_extensions` and `stablecoin` packages, and initialize stablecoin state\n\n   ```sh\n   yarn scripts deploy-and-initialize-token \\\n      -r http://localhost:8080 \\\n      --deployer-key \u003cPRIVATE_KEY\u003e \\\n      --token-config-path ./scripts/typescript/resources/default_token.json\n   ```\n\n   [!NOTE]\n\n   - The private key can be found inside `.aptos/keys/deployer.key`.\n   - The deployment uses default configurations inside \"./scripts/typescript/resources/default_token.json\". For a real deployment, please make a copy of `scripts/typescript/resources/usdc_deploy_template.json` and fill in all settings.\n\n4. [Optional] Upgrade the `stablecoin` packages\n\n   ```sh\n   yarn scripts upgrade-stablecoin-package \\\n      -r http://localhost:8080 \\\n      --admin-key \u003cPRIVATE_KEY\u003e \\\n      --payload-file-path \u003cPUBLISH_PAYLOAD_FILE_PATH\u003e \\\n      --aptos-extensions-package-id \u003cADDRESS\u003e \\\n      --stablecoin-package-id \u003cADDRESS\u003e\n   ```\n\n## Deploying to a live network\n\n1. Create a deployer keypair and fund it with APT\n\n   If deploying to a test environment (local/devnet/testnet), you can create and fund the account with the following CLI command\n\n   ```sh\n   # Local\n   yarn scripts generate-keypair --prefund\n\n   # Devnet\n   yarn scripts generate-keypair --prefund --rpc-url \"https://api.devnet.aptoslabs.com\" --faucet-url \"https://faucet.devnet.aptoslabs.com\"\n\n   # Testnet\n   yarn scripts generate-keypair --prefund --rpc-url \"https://api.testnet.aptoslabs.com\" --faucet-url \"https://faucet.testnet.aptoslabs.com\"\n   ```\n\n   If deploying to mainnet, create a keypair and separately fund the account by purchasing APT.\n\n   ```sh\n   yarn scripts generate-keypair\n   ```\n\n2. Create token configuration by copying existing template.\n\n   ```sh\n   cp scripts/typescript/resources/usdc_deploy_template.json scripts/typescript/resources/\u003cCONFIG_FILE_NAME\u003e\n   ```\n\n   Fill out all configuration parameters.\n\n3. Deploy `aptos_extensions` and `stablecoin` packages, and initialize stablecoin state\n\n   ```sh\n   yarn scripts deploy-and-initialize-token \\\n      -r http://localhost:8080 \\\n      --deployer-key \u003cPRIVATE_KEY\u003e \\\n      --token-config-path \u003cTOKEN_CONFIG_FILE_PATH\u003e\n   ```\n\n   Source code verification is disabled by default, but can be enabled via the `--verify-source` flag.\n\n## Interacting with a deployed token\n\nWe have provided scripts that enable developers to interact with a deployed token. To view a list of available scripts and their options, use the following command:\n\n```sh\nyarn scripts --help\n```\n\nIf you want to see the specific options for a particular script, replace `\u003cSCRIPT_NAME\u003e` with the name of the script and run:\n\n```sh\nyarn scripts \u003cSCRIPT_NAME\u003e --help\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcirclefin%2Fstablecoin-aptos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcirclefin%2Fstablecoin-aptos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcirclefin%2Fstablecoin-aptos/lists"}