abridged / collabland-dev Goto Github PK

netlify auto-build is running under Kenny's account still, need to reclaim control of it

add callout for tokenID list

• https://docs.collab.land/help-docs/command-center/create-a-tgr/evm/mainnet-erc1155#erc1155-collection-not-listed-on-opensea-mainnet-or-not and
• section on tokenID https://docs.collab.land/help-docs/command-center/create-a-tgr/how-to-create-a-tgr#how-to-create-a-tgr

Prize Title

Create Verifiable Credentials [Collab.Land](http://Collab.Land) Can VC Gate From

Prize Bounty

5000 USDC

Possible introduction to MetaCartel for further funding

Challenge Description

[Collab.Land](http://Collab.Land) is a token gating platform that allows communities to restrict access to private communities based on NFT and Fungible token ownership. Verifiable Credentials (VCs) are a new category of signed off chain messages.
https://en.wikipedia.org/wiki/Verifiable_credentials

[Collab.Land](http://Collab.Land) will soon allow token gating based on 3rd party Verifiable Credentials. Some examples include token gating based on: “Your platforms most active users”, “different skill tiers in your online game as defined by VCs issued to users”, “Web2 memberships that come with VCs”. The possibilities are endless. What matters though is the value creation for your users and the Collab.Land ecosystem.

Your challenge is to generate VCs for users from a new or existing platform and propose how they could be used by a community admin to gate community specific chats or features.

For example, all United Airlines Platinum Members gain access to a VC gated customer support real time chat room... You get the idea.

Following the W3C Verifiable Credentials Standard. This proposal from Nuggets to [Collab.Land](http://Collab.Land) provides many useful links: https://github.com/orgs/abridged/discussions/64

Collab.Lands current VC schema: APPENDIX A

Submission Requirements

1. a powerpoint/ google slides - still working on an example to share. these are the current slide titles

• Executive Brief
• Simple Summary
• Abstract
• Motivation
• Specifics
• Opportunity
• User Impact

2. a video explaining the proposal under 5 minutes (shows energy and personality)
3. A video demoing the code and VC generation in under 5 minutes

Judging Criteria

A successful project will show a compelling use case for issuing VCs for use by Community Admins.

Criteria will include:
Value created for the end user
effort put in by the team/ maturity of POC
Feasibility of becoming a widely used product/ use case

Value add to the [Collab.Land](http://Collab.Land) ecosystem

Compelling story that users can understand

Ability to follow through and take the POC into an MVP and eventually production

Winner Announcement Date

One winner will be chosen from all the submissions and will be announced 1 week after submissions close.

Resources

Teams can ask questions in our Discord here:
https://discord.gg/thmcqDx3ys
Note: real time support is only available for hackathon related questions.
Our FAQ and all other questions should be directed to https://collabland.freshdesk.com/

Refer to the "Consume VCs" bounty for additional information: https://github.com/orgs/abridged/discussions/63

APPENDIX A

//=============================================================================
// Licensed Materials - Property of Abridged, Inc.
// (C) Copyright Abridged, Inc. 2022
//=============================================================================

import {auth} from '@collabland/api-security';
import {debugFactory, generateIdSync} from '@collabland/common';
import {userOnly} from '@collabland/component-authorization';
import {experimental} from '@collabland/component-platform';
import {VeramoService, VERAMO_SERVICE} from '@collabland/component-veramo';
import {BindingScope, inject, injectable} from '@loopback/core';
import {get, oas, post, requestBody} from '@loopback/rest';
import {SecurityBindings} from '@loopback/security';
import {DISCORD_SERVICE} from '../keys';
import type {DiscordService} from '../services/discord.service';
import {getDiscordGuildId} from '../services/discord.service';
import {VC} from '../types';

const debug = debugFactory('collabland:veramo-vc');

export interface UserInfo {
  provider?: string;
  alias: string;
  nickname: string;
  name: string;
  picture: string;
}

interface UserProfile {
  id: string;
  verifying: VerifyingRoles[];
}

interface VerifyingRoles {
  communityId: string;
  roleId: string;
  roleName: string;
}

interface DiscordUser {
  roles: string[];
  avatar: string;
  joined_at: string;
  user: {
    id: string;
    username: string;
    avatar: string;
    discriminator: string;
    public_flags: number;
  };
}

interface CredentialSubjectData {
  id: string;
  discordUserId: string;
  discordUserName: string; //`${user.username}#${user.discriminator}`,
  discordUserAvatar: string; //user.displayAvatarURL({ size: 512 }),
  discordGuildId: string; //
  discordGuildName: string;
  discordGuildAvatar: string; //guild.iconURL({ size: 512 }),
  discordRoleId: string;
  discordRoleName: string;
  description: string;
  exp?: number;
}
interface CredentialSubject {
  data: CredentialSubjectData | undefined;
  error?: string;
}

interface VCResponse {
  data: VC[];
  error?: string;
}

@experimental()
@auth()
@userOnly()
@injectable({scope: BindingScope.SINGLETON})
export class VeramoController {
  constructor(
    @inject(VERAMO_SERVICE)
    private veramoService: VeramoService,
    @inject(DISCORD_SERVICE) private discordService: DiscordService,
  ) {}

  /**
   * Get user VCs
   */
  @get('/veramo/did/{user}')
  @oas.response(200, {
    type: 'array',
    items: {
      type: 'object',
      properties: {
        chain_id: {type: 'string'},
        deployment_address: {type: 'string'},
      },
    },
  })
  async getUserVCs(@inject(SecurityBindings.USER) currentUser: UserProfile) {
    return [];
  }

  /**
   * Generate VCs for based on roles
   *
   * @example credentialSubject: {
        // user
        discordUserId: '412814486332899338',
        discordUserName: `Agnes | Collab.Land#2623`,
        discordUserAvatar: '14f020ef756a37284281ebbba8ea84a9',
        // community
        discordGuildId: '903656119656910908',
        discordGuildName: 'CL',
        discordGuildAvatar: '',
        // role
        discordRoleId: '907634262461784084',
        discordRoleName: 'BKA',
        description: 'user Agnes has role BKA in community CL',
      },
   *
   */
  @post('/veramo/identity')
  @oas.response(200, {
    type: 'object',
  })
  async generateVc(
    @inject(SecurityBindings.USER) currentUser: UserProfile,
    @requestBody()
    profile: {aeToken: string; verifying: VerifyingRoles[]},
  ): Promise<VCResponse> {
    debug('decode AE token', currentUser);
    debug('roles', profile.verifying);

    const builtCredentials: CredentialSubject[] = [];

    for (const role of profile.verifying) {
      const roleInfo = await this.buildRoleInfo(role, currentUser.id);
      builtCredentials.push(roleInfo);
    }
    debug('builtCredentials', builtCredentials);
    // TODO: enable other platforms
    const userId = `DIS#USER#${currentUser.id}`;
    return this.getIdentity(userId, builtCredentials);
  }

  async getIdentity(userId: string, verifying: CredentialSubject[]) {
    return this.getIdentityAndUpdateProfile(userId, verifying);
  }

  /**
   * Veramo agent generates VC
   * @param userId
   * @param verifying
   * @returns
   */
  async getIdentityAndUpdateProfile(
    userId: string,
    verifying: CredentialSubject[],
  ): Promise<VCResponse> {
    const issuer = await this.veramoService.agent.didManagerGetOrCreate({
      alias: 'CollabLand',
      // provider: userInfo.provider,
    });

    const vcs: VC[] = [];
    for (const credential of verifying) {
      if (credential.error) {
        return {error: `Invalid community id: ${credential.error}`, data: []};
      }
      const vc = (await this.veramoService.agent.createVerifiableCredential({
        save: true,
        proofFormat: 'jwt',
        credential: {
          id: generateIdSync(),
          '@context': ['https://www.w3.org/2018/credentials/v1'],
          type: ['VerifiableCredential', 'DiscordRole'],
          issuer: {id: issuer.did},
          issuanceDate: new Date().toISOString(),
          credentialSubject: credential.data,
        },
      })) as unknown as VC;
      debug('VC', vc);
      vcs.push(vc);
    }
    return {data: vcs};
  }

  /**
   * Build role information based on the given userId and communityId
   * @param role selected role
   * @param userId example: 412814486332899338
   * @returns
   */
  async buildRoleInfo(role: VerifyingRoles, userId: string, ttl = -1) {
    const guildId = getDiscordGuildId(role.communityId);
    if (!guildId)
      return {
        error: `Invalid CommunityPk ${role.communityId}`,
        data: undefined,
      } as CredentialSubject;
    const commInfo = await this.discordService.getGuildInfo(guildId);
    const userInfo = (await this.discordService.getMemberInfo(
      guildId,
      userId,
    )) as unknown as DiscordUser;
    debug('Community info', commInfo);
    debug('User info', userInfo);
    const data = {
      id: userId,
      // user
      discordUserId: userId,
      discordUserName: `${userInfo.user.username}#${userInfo.user.discriminator}`,
      discordUserAvatar: userInfo.user.avatar
        ? this.discordService.cdn.avatar(userId, userInfo.user.avatar)
        : '',
      // community
      discordGuildId: commInfo.id,
      discordGuildName: commInfo.name,
      discordGuildAvatar: commInfo.icon
        ? this.discordService.cdn.icon(commInfo.id, commInfo.icon)
        : '',
      // role
      discordRoleId: role.roleId,
      discordRoleName: role.roleName,
      description: `${userInfo.user.username}#${userInfo.user.discriminator} has role ${role.roleName} in Discord community ${commInfo.name}`,
    } as CredentialSubjectData;
    if (ttl !== -1) {
      data.exp = Date.now() / 1000 + ttl;
    }
    return {
      data,
    } as CredentialSubject;
  }
}

• remove chat history req https://docs.collab.land/telefrens/create-a-tf-group#enable-chat-history
  • when devs say live in prod

• #172
• https://github.com/abridged/collabland-monorepo/issues/2367
• youtube tutorial video https://youtu.be/Cfy2aZvkXoQ

• Leather - STAMPS/Ordinals
• Xverse only ordinals

add to:

• https://docs.collab.land/help-docs/wallets/verify-your-wallet#supported-wallets
• https://docs.collab.land/help-docs/key-features/token-gate-communities#supported-blockchains--tokens

https://docs.google.com/spreadsheets/d/1fD4cMSVyry5Yd-WSIfgTY9DWsCJ8YCdMg2WsF02POz4/edit#gid=1794733328

https://docs.collab.land/telefrens/intro/#creator-pro-features

So, a crypto bonding curve is like a rollercoaster designed by a math nerd. It's this fancy graph that decides how much your passes are worth. The twist? The more people buy in, the higher its price climbs. But remember, this isn't your grandma's savings bond. The curve can go up or down, making it as unpredictable as Vin Diesel doing standup.

on https://docs.collab.land/dao/governance/contracts
use 1/100 for the contract default and 139/1000 for the additional factors

:::warning

Any server member who can view #collabland-config can change your TGRs. For security, make #collabland-config a private channel for your admins only.

:::

• https://docs.collab.land/help-docs/key-features/command-center
  • change TGRs to token gating rules
• https://docs.collab.land/help-docs/command-center/create-a-tgr/how-to-create-a-tgr

Prize Title

Consume Verifiable Credentials Created by [Collab.Land](http://Collab.Land)

Prize Bounty

5000 USDC

Possible introduction to MetaCartel for further funding

Challenge Description

[Collab.Land](http://Collab.Land) is a token gating platform that allows communities to restrict access to private communities based on NFT and Fungible token ownership. Verifiable Credentials (VCs) are a new category of signed off chain messages.
https://en.wikipedia.org/wiki/Verifiable_credentials

[Collab.Land](http://Collab.Land) will soon issue users VCs based on their activity, contributions, and accomplishments. Some example VCs may include “joining a community”, “being a member of 10 or more communities”, or “being a community admin”.

Your challenge is to propose a useful VC for Collab.Land to create for it’s members and to integrate the Collab.Land VC into a new or existing platform.

For example, a Collab.Land community admin automatically gets moderator rights in a decentralized social network platform...

Mock those VCs and show how they can be used inside your platform.

Following the W3C Verifiable Credentials Standard. This proposal from Nuggets to [Collab.Land](http://Collab.Land) provides many useful links: https://github.com/orgs/abridged/discussions/64

Submission Requirements

1. a powerpoint/ google slides - still working on an example to share. these are the current slide titles

• Executive Brief
• Simple Summary
• Abstract
• Motivation
• Specifics
• Opportunity
• User Impact

2. a video explaining the proposal under 5 minutes (shows energy and personality)
3. A video demoing the code and VC consumption in under 5 minutes

Judging Criteria

A successful project will show a compelling use case for consuming [Collab.Land](http://Collab.Land) generated VCs. Criteria will include:
Value created for the end user
effort put in by the team
Feasibility of becoming a widely used product/ use case

Value add to the [Collab.Land](http://Collab.Land) ecosystem

Compelling story that users can understand

Ability to follow through and take the POC into an MVP and eventually production

Winner Announcement Date

One winner will be chosen from all the submissions and will be announced 1 week after submissions close.

Resources

Teams can ask questions in our Discord here:
https://discord.gg/thmcqDx3ys
Note: real time support is only available for hackathon related questions.
Our FAQ and all other questions should be directed to https://collabland.freshdesk.com/

Refer to the "Create VCs" Bounty for additional information: https://github.com/orgs/abridged/discussions/62

https://docs.collab.land/help-docs/wallets/disconnect-your-wallet

https://discord.com/channels/904119310702772254/1060101026046292050/1121126486171193344

linked to dev updates https://github.com/abridged/collabland-monorepo/issues/2314

change background check language to balance check in the docs

• link on https://docs.collab.land/help-docs/intro
• add balance check section in https://docs.collab.land/help-docs/key-features/token-gate-communities
• update name to https://docs.collab.land/help-docs/command-center/bot-config/background-check

https://dev.collab.land/docs/downstream-integrations/api/token-gating

Remove bullets under Try it Out sections and make POST default black, same as under Sample Request syntax. There are three Try it Outs on that page that should be fixed.

See attached as example.

https://docs.collab.land/help-docs/key-features/gm-pass

• tech stack flowchart
  • https://whimsical.com/gmpass-onboarding-8knTfdF4FVCxBegUtpSJWn@2Ux7TurymN5ii8TLLKwC
  • https://whimsical.com/gmpass-txn-flow-TSuDgQTboPMq3SKVnJWpQy@2Ux7TurymMn4SpzrssMS
    password gmgmgm for both
• links to LIT
• links to Obvious
• [ ]

thread in slack, add NEAR info in 3 places

NEAR is non-evm, | NEAR | NEAR

• https://collabland.freshdesk.com/support/solutions/articles/70000641603-supported-chains-and-supported-tokens-of-collab-land
• https://docs.collab.land/help-docs/key-features/token-gate-communities#supported-blockchains--tokens
• https://docs.collab.land/help-docs/wallets/verify-your-wallet#supported-wallets
  • NEAR (NEAR, Meteor) | NEAR
• add OpenSea auth to wallet page also (EVM section, blank ------- network)

hi @kenny-io

https://dev.collab.land/tutorials/token-gating

As subject title, the full-screen mode seems disabled. However I can copy the url directly into the browser and then make it full screen.

script to go on this page
https://github.com/abridged/collabland-dev/blob/master/help-docs/command-center/create-a-tgr/evm/mainnet-erc1155.md

• https://docs.collab.land/dao/governance/proposals with whimsical flowchart https://whimsical.com/collab-dao-proposal-flow-VWP4rfvQdiXUGoFuASF5Ku
• funding on gov docs

💛 Report scams

Please report all suspicious accounts and potential scams in the #report-scam channel.

How to Report to Collab.Land

1. Post a screenshot of the message.
2. Include the user id of the sender.

How to get someone's discord user id.

You can also send your report via email to: [email protected]
Or submit a support ticket with the details of the scam.

How to Report to Google

1. Visit https://safebrowsing.google.com/safebrowsing/report_phish/?hl=en
2. Paste the scam link in URL field
3. Click "submit report"

How to Report an account to Discord

1. Start a discord report
2. Select Developer Compliance
3. Report an app/bot
4. Scams, fraud or cracked accounts

Note: You will need to add the message link and the fake bot's discord ID

How to Report to Twitter (scam link)

1. Click the ... in the top right of the profile or tweet
2. Report tweet/account
3. Everyone on Twitter
4. Offered tips or currency ... or causes harm
5. Tricking other people into sending tips, currency, or private financial info

How to Report to Twitter (impersonation)

1. Click the ... in the top right of the profile or tweet
2. Report tweet/account
3. Everyone on Twitter
4. They're being impersonated or shown a deceptive identity
5. Pretending to be them
6. Select account being impersonated

How to Report a collection to OpenSea

1. Click on the ... icon located next to the item or user's name that you want to report.
2. Select "Report this item" or "Report this user" from the drop-down menu.
3. Choose the reason for your report from the available options.
4. Provide any additional information about the spam that you have observed.
5. Click "Submit" to send your report to OpenSea's support team.

The font size for heading Collab.Land APIs and next sub heading should be at a lower font size hierarchy to match the rest of the pages.

Please see two images below for comparison.

For pfp:

• users need to edit their privacy setting so that the bot can see their photos
• we have tg pfp cached. Telefrens will pick up the change in 24 hour

contributing.md

• add footer link "Contribute to the docs" that links to github docs repo
• #204

https://help.collab.land/governance/charter to https://docs.collab.land/dao/intro

• https://github.com/Redocly/redoc
• to achieve something like discourse api reference

https://app.joinorigami.com/orgs/258692110553841664/proposals/358130094115250176

• How long does it take the bot to kick out someone who sold their pass?
• how do i change my pfp in telefrens? -- change in tg
• how do i change my name in telefrens? -- change in tg

https://help.collab.land

Objective:

Create v1 of DevX website and add documentation

User Story:

As a 2nd or 3rd party developer I need to have a clear idea of how I can get started with contributing to Collab.Land.

Acceptance Criteria:

• Clearly defined documentation for getting started with Collab.Land

Technical Details:

• https://www.notion.so/collab-land/Monetization-ideas-4cbd1c6f08144d569c6be0893b6f4ec7?pvs=4#40f35c7df6374cffa6ddc60b9dc83e25
• https://docs.collab.land/help-docs/marketplace/getting-started#miniapp-subscriptions

Add search to devX docs site

add TOS and privacy policy links to docs

• https://docs.collab.land/dao/governance/charter/
• https://docs.collab.land/help-docs/FAQ/collab-land-project

Collab Token

https://docs.collab.land/help-docs/FAQ/collab-token

• title "How to Acquire $COLLAB tokens"
• add token story references https://wagmi.collab.land/
• add link to $COLLAB token page in DAO docs

add more FAQs

• Port Collab.Land Project FAQ from Notion

DevRel Live

• https://www.youtube.com/watch?v=PAawAIMWd-8&list=PLQbEq7a9kYPnL_OOQ25_6cQc5gqu3yL6r&index=2
• https://www.youtube.com/watch?v=QG1Qy62l8XI&list=PLQbEq7a9kYPnL_OOQ25_6cQc5gqu3yL6r&index=3
• https://www.youtube.com/watch?v=P6PE6_grTxo&list=PLQbEq7a9kYPnL_OOQ25_6cQc5gqu3yL6r&index=4&pp=gAQBiAQB
• https://www.youtube.com/watch?v=T9JAWAZmdzA&list=PLQbEq7a9kYPnL_OOQ25_6cQc5gqu3yL6r&index=5&pp=gAQBiAQB
• https://www.youtube.com/watch?v=29PjagBTv3k&list=PLQbEq7a9kYPnL_OOQ25_6cQc5gqu3yL6r&index=6&pp=gAQBiAQB
• https://www.youtube.com/watch?v=GrCZWlhnXTw&list=PLQbEq7a9kYPnL_OOQ25_6cQc5gqu3yL6r&index=7&pp=gAQBiAQB
• https://www.youtube.com/watch?v=qfguat13Xwc&list=PLQbEq7a9kYPnL_OOQ25_6cQc5gqu3yL6r&index=8&pp=gAQBiAQB
• https://www.youtube.com/watch?v=bRyeOpke6uU&list=PLQbEq7a9kYPnL_OOQ25_6cQc5gqu3yL6r&index=9&pp=gAQBiAQB
• https://www.youtube.com/watch?v=8ot2gZlwPSs&list=PLQbEq7a9kYPnL_OOQ25_6cQc5gqu3yL6r&index=10&pp=gAQBiAQB

old tutorials playlist

• https://www.youtube.com/watch?v=zP3jEEdNo18&list=PLQbEq7a9kYPlvjfdJp3msChLJ7kFufyI2&index=4

Dev Deep Dives

Docusaurus blog documentation

• add a subscribe button to sidebar
• protect button with hcaptcha

Objective:
Provide design for the DevX website.

User Story:

For finishing the DevX website front-end work, we need the designs.

Acceptance Criteria:

Have a design compatible with Docusaurus & with our new branding.

Technical Details:

Charles will crate a wireframe after Micheal briefs him on the DevX website. Michael will also start a Document for Design.

• Add feedback to https://docs.google.com/document/d/1sdVpatldBfzq1winhqQ-wJdjPpIIArTSHt6NQsAbdEA/edit
• Update improvements/suggestions in repo: https://github.com/abridged/collabland-dev
• fill the gaps in 2nd party documentation, update the tutorial if needed
• Understand how different parts work together (join-flow.png)
• Improve/update the local Discord bot/local API server setup docs

Write the RaidGuild case study

new docs page erc7160 https://docs.collab.land/help-docs/command-center/create-a-tgr/evm/mainnet-erc1155

• workaround: add info to use the OpenSea token type when making TGRs

https://docs.collab.land/docs/upstream-integrations/#zero-to-hero-with-miniapps

• remove Kenny references
• remove cadence on Demo Day

Token Story

• remove "Process for transferring locked tokens" section from token story
• add "claim has ended as of " banner at top of the token claim FAQ token story

medium post https://medium.com/collab-land/opensea-auth-is-now-live-on-collab-land-8494224fba7f

• create docs at to https://docs.collab.land/help-docs/wallets/connecting-using-different-wallets/opensea
• add gif https://abridged-io.slack.com/files/U04B4AXLJTE/F05PUV05M3R/go_back_to_discord_celebrate_new_roles_tada_.gif
• stepwise directions (step1, step2...)

Updated the wording on first paragraph to the following:

Collab.Land provides solutions for managing Web3 communities by token-gating the channels and groups. Besides token-gating, we support features such as Tipping(currently limited access), Verifiable Credentials, Decentralized Identities (DIDs), and more. Our goal is to bring web2 users to web3. Notably, for our web2 users we support platforms such as Discord, Telegram, and soon Reddit, Github, and Notion. For our web3 users, we support all the popular chains

specific suggested changes for FYI:
Besides token-gating
Our goal is to bring web2 users to web3
Notably for our web2 users
For our web3 users

enable community to make issues/PRs in the repo to improve docs