https://github.com/heavy-duty/platform

Monorepository of Heavy Duty Builders.
https://github.com/heavy-duty/platform

Last synced: about 1 month ago
JSON representation

Monorepository of Heavy Duty Builders.

• Host: GitHub
• URL: https://github.com/heavy-duty/platform
• Owner: heavy-duty
• Created: 2021-10-05T16:36:27.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2023-02-09T03:49:17.000Z (almost 2 years ago)
• Last Synced: 2024-08-01T08:16:15.062Z (4 months ago)
• Language: TypeScript
• Homepage:
• Size: 15 MB
• Stars: 80
• Watchers: 4
• Forks: 24
• Open Issues: 22
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome - heavy-duty/platform - Monorepository of Heavy Duty Builders. (TypeScript)

README

        
# Bulldozer [![Bulldozer Platform ci](https://github.com/heavy-duty/platform/actions/workflows/bulldozer-platform-ci.yaml/badge.svg?branch=master)](https://github.com/heavy-duty/platform/actions/workflows/bulldozer-platform-ci.yaml)

Bulldozer is a low code platform that uses abstractions that are common for developers to build Solana programs, it’s powered by Anchor Framework. It gives developers the ability to manage their program’s ecosystem through a UI, hiding all the gory details so they can focus on the business logic.

It consists of an Anchor workspace and an Angular application, the Anchor workspace holds the content of the Bulldozer program, it's used as decentralized storage. The reason we store all the data on-chain is that we want to unlock real-time collaboration while building systems.

![screenshot_of_bulldozer](https://user-images.githubusercontent.com/7496781/165176684-c969cec9-2665-4cd4-a99e-608abb42dba2.png)

## Running Locally

Bulldozer has only been tested in localhost, if you want to give it a test drive, make sure to have a local validator running using `solana-test-validator`.

In order to run Bulldozer in your local environment, you'll need to make sure you have installed globally these dependencies:

- @project-serum/anchor

- mocha

- ts-mocha

- typescript

- npm

- node

Clone the repo in the desired location and `cd` to it and run `npm i`. It's time to build the program and deploy it! Every Solana program needs a Keypair, Bulldozer is not different. We used one during development but you'll need to set up your own and replace it in some files.

I know, it's boring, but this is temporal. We'll figure out a better way. For now, cd into `apps/bulldozer-programs` and run `anchor keys list`, you should see a PublicKey, this key matches a new generated Keypair under `/apps/bulldozer-programs/target/deploy/bulldozer-keypair.json`.

Copy that PublicKey and replace it in these places:

- bulldozer program id in `apps/bulldozer-programs/Anchor.toml`

- declare_id in `apps/bulldozer-programs/programs/bulldozer/src/lib.rs`

- BULLDOZER_PROGRAM_ID const in `libs/bulldozer/shared/devkit/src/lib/programs/bulldozer-program/bulldozer-program.ts`

Now you run these commands from the root path:

- `npx nx build bulldozer-programs`

- `npx nx deploy bulldozer-programs`

- `npx nx serve bulldozer-client`

- `npx nx serve broadcaster`

Those three commands will build the program, deploy it to your local validator instance and start a server at port 4200 with the client application.

NOTE: Make sure to point the solana config in your local environment to match the local instance you have running.

## Testing it

If you want to run the program's e2e tests you can call `npx nx test bulldozer-programs` from the root of the project. Make sure to kill any local instance of Solana, it can make the tests fail.