Skip to content

Commit

Permalink
Add some blog posts
Browse files Browse the repository at this point in the history
  • Loading branch information
tupui committed Sep 15, 2024
1 parent a6ab9f0 commit 5678ee7
Show file tree
Hide file tree
Showing 5 changed files with 95 additions and 5 deletions.
2 changes: 0 additions & 2 deletions website/blog/2024-07-15-welcome/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,5 +52,3 @@ In order to facilitate the use of the Soroban Versioning smart contract, we will
Maintainers will be able to register and administer many aspects of their projects. From adjusting the list of maintainers to update the last hash. Anyone will be able to view the projects, their configurations and the Git history.

This will be achieved through a backend infrastructure by linking on-chain data with what is available on GitHub.


37 changes: 37 additions & 0 deletions website/blog/2024-08-01-testnet.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
slug: testnet
title: testnet
authors: pamphile
tags: [soroban, scf]
---

A quick update 😃 The project is progressing very well and the contract is on testnet!

<!-- truncate -->

## Contract

The new address is https://stellar.expert/explorer/testnet/contract/CAP52ERGUZ65UNPHP36CQBHYUPEUG2TT4NPVEV7CREWRT7UCPD7PRWEE if you want to have a look.

## Register a new project

- Automatically check for an existing Soroban Domain (was actually not part of the deliverable but I thought it was necessary 🤘) and create one with the project name. Still figuring things out, but I think that it is a fairly good anti-abuse measure as people need to put collateral for a domain to register a project on Tansu.
- Push a new hash
- Get hash
- All these trigger events

## Backend

- Pre-commit hook machinery working. I am actually using it everytime I push. This allows us to monitor things like fees and general behaviour of the system. Get a feel for it.
- Event handling: DB setup and event ingestion, consumption and listeners parts are there.
- Small Python library for event handling helpers, tansu on PyPi.

## Next up

- POC of dApp is on the way (hopefully I can share news next week).
- Backend FastAPI for events and CRUD endpoints for the dApp
- Deploy the DB (we have a domain name, but nothing to show yet. Remember, design is my passion 😅 )
- Work on the config file
- Lot of small things, and cool stuff like continuous deployment for the contract (already there for the Python part.) Oh and I participated in the effort to improve the online doc of Soroban. Thanks to the knowledge I am getting while building this project, I was able to make 2 contributions (events and SAC testing). Maybe another one incoming.

If you want to follow a bit closely what we do, you can check out our project board https://github.com/users/tupui/projects/1 and please ask us questions and we are more than happy to get feedbacks 🙂 Thanks everyone for following us 🚀
55 changes: 55 additions & 0 deletions website/blog/2024-09-15-v1.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
slug: v1
title: v1 on testnet
authors: pamphile
tags: [soroban, scf]
---

We have a v1! 🎉

Tansu is not officially available on testnet and people can register their project and explore our dApp.

https://testnet.tansu.dev/

<!-- truncate -->

This v1 mark the end of our [SCF28](https://dashboard.communityfund.stellar.org/scfawards/scf-28_43/activationawardreview/suggestion/1150) activation award. It has been a fantastic experience with its up and downs, but thanks to Stellar's awesome community, we are happy to say that we exceeded expectations by delivering more than we planned!

Let's recap what we set ourselves to:

> Deliverable 1: Soroban Smart Contract
>
> - Description: Soroban smart contract to register, edit, view and push new commits. And infrastructure to handle events.
> - How to measure: GitHub, contract deployed on testnet and tools to use the contract.
>
> Deliverable 2: dApp
>
> - Description: dApp which allows to register a project, get information, view the Git history pushed on-chain and compare it to the off-chain version.
> - How to measure: GitHub and functional dApp publicly available.
Done ✅and as promised, everything is open source and available on GitHub: https://github.com/tupui/soroban-versioning

## Stellar smart contract

The smart contract is foundational to our project. We iterated to get this right with how we would consume it from both the dApp and other developers tool.

One major extra, we spent time on, was to add support for Soroban Domains. This was marked as a thought in our original proposal, but we thought it was important to have it as soon as possible. Thanks to this integration, all projects which are registered on Tansu need to have a domain. The domain registration is done automagically for you. This is great as it offers a way for projects to have their own domain (e.g. useful for fund-raising, something we will add support for) and also safeguard malicious activities.

## Tooling

- We developed a pre-push commit hook which can be used by maintainers who are used to push on their main branch locally.
- A lot of work was put into developing a backend and ingestion system for the events. There is still some work to do but this is more than a good starting point for the next phase of the project.
- The tools around event handling have been released as a Python package https://pypi.org/project/tansu/
- Let's not forget the comprehensive CI/CD setup which helped us develop with confidence. We have linters, pre-commit hooks, tests and release workflows.

## dApp

We had a slow start with the dApp development. But the team did a great push in last 2 weeks to deliver what we think is a great user experience. We still have a lot of ideas to make this even simpler to use and we will put some focus on writing more documentation.

## Wrap up!

Tansu is ready to be tested. Head over to https://testnet.tansu.dev/ and register your project.

We would like to thank everyone for their help and support along the way. We are happy and grateful to be part of the Stellar community and cannot wait to show you what we have in store for Tansu. If you have feedbacks or requests for Tansu, please reach out to the team, we would love to hear from you.

Now, on to the next step: a Build award!
2 changes: 1 addition & 1 deletion website/blog/tags.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
soroban:
label: soroban
permalink: /soroban
description: Soroban Smart Contract
description: Stellar Smart Contract

scf:
label: scf
Expand Down
4 changes: 2 additions & 2 deletions website/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@
"write-translations": "docusaurus write-translations",
"write-heading-ids": "docusaurus write-heading-ids",
"typecheck": "tsc",
"format:mdx": "prettier --write \"{docs,src/pages}/**/*.{md,mdx}\"",
"check:mdx": "prettier -c \"{docs,src/pages}/**/*.{md,mdx}\""
"format:mdx": "prettier --write \"{blog,docs,src/pages}/**/*.{md,mdx}\"",
"check:mdx": "prettier -c \"{blog,docs,src/pages}/**/*.{md,mdx}\""
},
"dependencies": {
"@docusaurus/core": "3.5.2",
Expand Down

0 comments on commit 5678ee7

Please sign in to comment.